---
author: OOMOL
author_url: https://oomol.com/ko/about/
datePublished: 2026-11-11
title: "MCP와 API: 차이, 예제, 선택 방법"
description: 동일한 읽기 전용 계정 조회로 MCP와 API의 도구 검색, 인증, 실행, 오류 처리를 비교합니다.
lang: ko
canonical_url: https://oomol.com/ko/blog/mcp-vs-api/
markdown_url: https://oomol.com/ko/blog/mcp-vs-api.md
---

코드가 작업과 입력을 정해야 하면 직접 API를 호출하고, AI 클라이언트에 공통 도구 인터페이스가 필요하면 MCP를 사용할 수 있습니다. MCP 서버 내부에서도 API를 호출하므로 함께 사용할 수 있습니다.

## 인터페이스의 차이

API/SDK에서는 코드가 작업과 응답 처리를 정합니다. MCP에서는 클라이언트가 서버의 도구를 발견하고 프로토콜로 호출합니다. 원본 서비스 권한은 여전히 필요합니다. [공식 아키텍처](https://modelcontextprotocol.io/docs/learn/architecture)를 참고하세요.

## 같은 작업으로 비교하기

OOMOL에 연결한 GitHub 사용자 정보를 두 방식으로 확인합니다. 먼저 계정을 연결하고 대상을 확인하세요.

## 백엔드에서 호출하기

`@oomol-lab/connector`를 설치하고 개인 API 키를 백엔드 비밀 값 `OOMOL_API_KEY`에 저장합니다. 신뢰할 수 있는 서버 환경에서만 실행하세요.

```ts
import { Connector } from "@oomol-lab/connector";

const connector = new Connector({
  apiKey: process.env.OOMOL_API_KEY!,
  team: "<team-name>",
});
const result = await connector.execute("github.get_current_user", {});
console.log(result);
```

`<team-name>`을 GitHub 연결이 있는 OOMOL 팀 이름으로 바꾸고 아래 MCP 설정에서도 같은 팀을 선택하세요.

반환 계정을 확인합니다. 여러 연결 중 선택하는 방법은 [Connector 가이드](/ko/docs/connector-client/)를 참고하세요. 개인 키, 프로젝트 키, MCP 키는 서로 다릅니다.

## MCP로 호출하기

[MCP 설정](/ko/install/mcp/)에서 올바른 개인 또는 팀 범위를 선택하고 호환 클라이언트에 추가합니다.

> OOMOL MCP로 연결된 GitHub 사용자를 조회하세요. 연결이 여러 개면 선택을 요청하세요. 실제 신원 필드를 반환하고 아무것도 수정하지 마세요.

같은 계정인지 확인하세요. OOMOL은 검색 및 실행 도구를 제공하므로 각 GitHub 작업이 별도 MCP 도구로 표시되지 않을 수 있습니다. 인증은 [MCP 가이드](/ko/docs/agents/mcp/)를 따릅니다.

## 같은 작업의 호출 과정 비교

SDK 예제는 GitHub에 직접 요청하지 않고 OOMOL의 호스팅 API를 사용합니다. 직접 GitHub를 연동하면 인증 정보와 응답을 별도로 처리해야 합니다.

| 단계 | OOMOL SDK | MCP 클라이언트 |
| --- | --- | --- |
| 검색 | `connector.catalog.action("github.get_current_user")` 확인. | 도구와 schema를 찾고 OOMOL 도구로 작업 검색. |
| 입력 | 작업 ID와 `{}` 전달, 계정은 별도 선택. | 도구 schema에 맞는 인수와 필요한 계정 전달. |
| 인증 | 개인 키, 팀, GitHub 연결. | MCP 키, 팀, 동일한 GitHub 연결. OAuth는 OOMOL 키를 대체하지 않음. |
| 실행 | `connector.execute(...)` 대기. | 도구 호출, 호스트가 승인과 실행 흐름 관리. |
| 결과 | `execute`는 데이터, `executeRaw`는 실행 정보도 반환. | 모델 요약 전에 도구 결과 확인. |

MCP는 검색과 호출 형식을 통일하지만 매번 모델이 작업을 고를 필요는 없습니다. 직접 API도 모델 도구로 제공할 수 있습니다. 두 방식 모두 호환성과 원본 API 변경을 관리해야 합니다.

## 오류부터 구분하기

인증 실패, 잘못된 팀, 연결 없음, 정상적인 빈 결과를 구분합니다. 키 없이 오류를 기록하세요. 더 큰 작업에서는 필터, 페이지 처리, 필드를 같게 맞추세요.

SDK에서는 `ConnectorError`를 잡아 `code`, `status`, 제공된 요청 또는 실행 ID를 확인합니다. 재시도 조건은 [SDK 문서](/ko/docs/connector-sdk/)를 참고하세요. 권한 오류는 키나 계정 선택부터 수정합니다. MCP에서는 연결 오류와 도구 실패를 구분합니다. 검색은 되지만 GitHub 조회가 실패하면 팀과 연결을 확인하세요. 비밀 값을 제외한 오류와 작업 ID를 보존합니다.

## 워크플로에 맞게 선택하기

일정, 입력, 재시도를 코드로 관리하려면 API/SDK를, AI 클라이언트가 도구를 발견하도록 하려면 MCP를 고려하세요. 단순 API에는 추가 플랫폼이 필요 없을 수 있습니다. [SDK 문서](/ko/docs/connector-sdk/)는 개인/팀과 고객 계정을 구분합니다. [OOMOL Chat](https://console.oomol.com/overview) 또는 [GitHub](/ko/integrations/github/), [Search Console](/ko/integrations/google_search_console/) 작업으로 이어갈 수 있습니다.
