본문으로 건너뛰기
← 블로그로 돌아가기

MCP와 API: 차이, 예제, 선택 방법

동일한 읽기 전용 계정 조회로 MCP와 API의 도구 검색, 인증, 실행, 오류 처리를 비교합니다.

OOMOL

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

인터페이스의 차이

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

같은 작업으로 비교하기

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

백엔드에서 호출하기

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

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 가이드를 참고하세요. 개인 키, 프로젝트 키, MCP 키는 서로 다릅니다.

MCP로 호출하기

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

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

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

같은 작업의 호출 과정 비교

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

단계OOMOL SDKMCP 클라이언트
검색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 문서를 참고하세요. 권한 오류는 키나 계정 선택부터 수정합니다. MCP에서는 연결 오류와 도구 실패를 구분합니다. 검색은 되지만 GitHub 조회가 실패하면 팀과 연결을 확인하세요. 비밀 값을 제외한 오류와 작업 ID를 보존합니다.

워크플로에 맞게 선택하기

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