UnifAPI MCP를 범용 및 코딩 에이전트에 연결하기

요약: MCP 설정 검색을 위한 온보딩 글입니다. 호스팅된 UnifAPI 서버를 추가하고, OAuth로 인증한 다음, 이미 사용 중인 에이전트 클라이언트에서 Skill을 실행하세요.

호환되는 범용 에이전트, 리서치 에이전트, 코딩 에이전트, 또는 MCP 지원 클라이언트에 UnifAPI 공개 데이터 접근을 부여하는 가장 빠른 방법은 호스팅된 MCP 서버를 연결하는 것입니다. URL 하나를 추가하고, 클라이언트가 요청할 때 인증하면, 에이전트가 글루 코드를 작성하거나 플랫폼별 API 키를 붙여넣지 않고도 Skills를 실행할 수 있습니다.

표준 UnifAPI MCP 서버 URL은 https://mcp.unifapi.com 입니다. 클라이언트가 지원하는 곳에서는 OAuth를 사용하세요. API 키 베어러 인증은 호환성 경로로 남아 있지만, 대부분의 운영자에게 첫 설정 경로가 되어서는 안 됩니다.

무엇을 연결하는가

MCP는 에이전트에 도구 표면을 제공합니다. UnifAPI의 호스팅된 MCP 서버는 세 가지 카탈로그 도구를 노출합니다. 발견을 위한 list_operations, 스키마와 예시 검사를 위한 get_operation, 구체적인 공개 데이터 작업을 호출하기 위한 call_api입니다. 에이전트는 모든 API 엔드포인트마다 별도 도구가 필요하지 않습니다.

시작하기 전에

MCP 지원 클라이언트, OAuth가 열릴 때의 UnifAPI 계정, 그리고 공개 데이터 record를 반환하기에 충분한 워크스페이스 크레딧이 필요합니다. 로그인 전에 Skills를 둘러볼 수 있습니다. 로그인 시점은 에이전트가 실제로 도구를 호출해야 할 때여야 합니다.

Claude Desktop이나 Claude.ai 커스텀 커넥터로 테스트한다면, 원격 커넥터가 Anthropic의 클라우드를 통해 중개된다는 점을 기억하세요. MCP 서버는 공개 인터넷에서 도달 가능해야 합니다. https://mcp.unifapi.com에는 문제가 없으며, 비공개 로컬 서버에서만 문제가 됩니다.

Codex

Codex는 Codex CLI와 공유 설정을 통해 원격 HTTP MCP 서버를 지원합니다. 다음으로 UnifAPI를 추가하세요.

codex mcp add unifapi --url https://mcp.unifapi.com

그런 다음 서버가 설정되었는지 확인하세요.

codex mcp list

새 Codex 세션을 열고 일반적인 API 호출이 아니라 Skill 방식의 작업을 요청하세요. 예를 들어: Run a KOL pricing pass for these Twitter/X creators using UnifAPI public data. Return ranges, evidence, confidence, and follow-up questions.

Claude Code

Claude Code의 현행 레퍼런스는 가능한 경우 클라우드 MCP 서버에 원격 HTTP를 권장합니다. Claude Code가 사용할 프로젝트에서 UnifAPI를 추가하세요.

claude mcp add --transport http unifapi https://mcp.unifapi.com

여러 프로젝트에서 서버를 사용하려면 user 스코프를 사용하세요.

claude mcp add --transport http --scope user unifapi https://mcp.unifapi.com

Claude Code 안에서 /mcp를 실행하여 연결 상태를 확인하고 필요하면 OAuth를 완료하세요. 서버가 .mcp.json을 통해 프로젝트 스코프로 설정되어 있으면, Claude Code가 사용 전에 승인을 요청할 수 있습니다.

Claude Desktop과 Claude.ai

Claude Desktop이나 Claude.ai의 원격 MCP 커넥터는 Customize -> Connectors -> + -> Add custom connector를 사용하세요. UnifAPI처럼 명확한 이름을 입력하고 커넥터 URL https://mcp.unifapi.com을 사용한 다음, Connect를 클릭하여 인증하세요.

메뉴를 거치지 않아도 됩니다. 이 링크를 열면 이름과 URL이 미리 채워진 같은 대화상자가 나타납니다. 확인한 뒤 Add, 이어서 Connect를 클릭하세요.

원격 커넥터를 예전의 로컬 전용 Desktop MCP 설정과 혼동하지 마세요. 원격 커넥터는 Claude 설정 UI에서 추가되며, 연결된 후에는 여러 Claude 표면에서 사용할 수 있습니다. 데스크톱 설정을 통해 구성한 로컬 stdio 서버는 별개의 메커니즘입니다.

Cursor

Cursor는 mcp.json을 통해 MCP를 지원합니다. 전역 설정에는 ~/.cursor/mcp.json을 만들거나 편집하세요. 프로젝트 전용 설정에는 프로젝트에 .cursor/mcp.json을 만드세요.

다음 원격 서버 형태를 사용하세요.

{ "mcpServers": { "unifapi": { "url": "https://mcp.unifapi.com" } } }

서버가 즉시 나타나지 않으면 Cursor를 재시작하거나 MCP 도구 뷰를 새로 고치세요. Cursor의 에이전트는 관련이 있을 때 활성화된 MCP 도구를 사용하며, 설정에 따라 도구를 실행하기 전에 승인을 요청할 수 있습니다.

처음 실행할 Skill

에이전트에게 원하는 결과와 검사할 증거를 알려주는 작업 프롬프트를 사용하세요. 좋은 첫 실행은 이것입니다.

Find Twitter/X KOLs discussing AI coding tools and summarize the best outreach angles. Use UnifAPI public data through MCP. Return a ranked shortlist, public evidence, risk notes, and follow-up questions. Keep the workflow bounded to public data.

두 번째로 유용한 테스트는 이것입니다.

Find the top three TikTok videos about Anthropic this week. Use UnifAPI MCP. Show the public records you used, then summarize the pattern in one paragraph.

에이전트는 작업을 발견하고, 올바른 작업을 검사하고, 호출하고, 결과를 종합해야 합니다. 카탈로그를 검사하지 않고 엔드포인트 이름을 추측하려 하면, 먼저 list_operations와 get_operation을 호출하도록 요청하세요.

무엇이 과금되는가

워크스페이스 크레딧은 개당 $0.001입니다. 표준 과금 대상 record는 1크레딧이며, 비용이 더 높은 작업은 OpenAPI에서 최소 크레딧을 게시합니다. 첫 충전에 제공되는 2,000 크레딧 일회성 보너스는 몇 가지 가벼운 워크플로의 형태를 테스트하기에 충분합니다. 반복 실행이 필요해지면 사용량 기반 잔액을 충전하세요.

가장 중요한 비용 습관은 프롬프트를 제한하는 것입니다. 먼저 상위 10개 또는 상위 20개 record를 요청하고, 답이 유용할 때만 깊이 들어가세요. '이 시장에 대해 모든 것을 조사해줘' 같은 모호한 요청은 여러 작업으로 퍼질 수 있습니다. 'Reddit 스레드 20개를 가져와 반복되는 반대 의견을 요약해줘' 같은 제한된 요청은 검사하고 예산을 잡기가 더 쉽습니다.

문제 해결

확인한 출처

이 설정 가이드는 2026년 6월 2일에 공식 OpenAI Docs MCP 페이지, Claude Code MCP 레퍼런스, Anthropic의 커스텀 커넥터 헬프센터 문서, 그리고 Cursor의 MCP 문서에 맞춰 갱신되었습니다.

다음에 읽을 글

MCP 설정 - 현행 호스팅 커넥터 안내를 한곳에 모아둡니다.

MCP로 KOL 단가 산정 에이전트 운영하기 - 설정 후의 첫 작업을 제시합니다.

MCP 카탈로그 도구 설계 - 에이전트가 작업을 어떻게 발견하고 호출하는지 설명합니다.