에이전트 연결하기

공개 데이터 MCP 서버를 에이전트에 연결하세요 — 읽기 전용, OAuth, API 키 불필요. 오픈소스 에이전트와 skills는 github.com/unifapi-agent/agents에 있습니다.

대부분의 클라이언트에서는 설정 파일을 건드리거나 토큰을 붙여넣을 필요가 없습니다. 서버를 추가한 다음(붙여넣은 프롬프트 또는 웹 커넥터), 에이전트나 skill을 실행하고 에이전트가 처음 실시간 데이터를 필요로 할 때 OAuth로 로그인하세요.

에이전트 연결하기

여러분의 클라이언트에 맞는 경로를 선택하세요. 각 방법은 실시간 데이터를 위해 호스팅된 MCP 서버(https://mcp.unifapi.com)를 연결합니다. npx skills add unifapi-agent/agents로 에이전트 skills를 추가하세요.

프롬프트 하나 붙여넣기

Claude Code, Codex, Cursor, OpenClaw, Goose, Hermes — 자체 MCP 서버를 관리하는 모든 에이전트. 이것을 입력하면 서버를 추가하고 OAuth 로그인을 실행합니다:

Install the UnifAPI MCP server for me, then confirm it connected. It's a remote
(streamable HTTP) MCP server at https://mcp.unifapi.com. UnifAPI uses OAuth — open
the browser sign-in when prompted. It's read-only public data, no API key to paste.

웹 커넥터 (Claude, ChatGPT, Perplexity, Grok)

https://mcp.unifapi.com을 가리키는 커스텀 커넥터를 추가하고 OAuth로 인가하세요. ChatGPT는 Developer Mode가 필요합니다 (Plus, Pro, Team, Enterprise):

Settings -> Connectors -> Advanced -> enable Developer Mode
Connectors -> Create
MCP server URL: https://mcp.unifapi.com
Authentication: OAuth

Codex

Codex는 MCP와 skills를 별도로 연결합니다. ~/.codex/config.toml에 MCP 서버를 추가하세요:

[mcp_servers.unifapi]
url = "https://mcp.unifapi.com"

그런 다음 로그인하고 skills를 추가하세요:

codex mcp login unifapi
npx skills add unifapi-agent/agents

Claude 호환 플러그인 호스트

Claude Code, Claude Desktop, OpenClaw는 skills 와 MCP 서버를 한 번에 함께 설치할 수 있습니다:

/plugin marketplace add unifapi-agent/agents
/plugin install unifapi@unifapi

이후 에이전트나 skill을 실행하고 메시지가 표시되면 OAuth 로그인을 완료하세요.

기타 모든 MCP 클라이언트

skills를 추가한 다음, 실시간 데이터를 위해 클라이언트가 호스팅된 MCP 서버를 가리키도록 설정하세요:

npx skills add unifapi-agent/agents

MCP server URL: https://mcp.unifapi.com

실행하기

설치 후, 새 채팅이나 스레드를 시작하고 작업 결과를 요청하세요. 에이전트 skills는 필요에 따라 MCP를 통해 공개 데이터 작업을 발견하고 호출합니다:

Analyze these Twitter/X KOLs for an AI developer-tool campaign: @vercel, @shadcn, @rauchg.
Use UnifAPI public data and return price ranges, evidence, confidence, and follow-up questions.

OAuth는 에이전트가 처음 UnifAPI 도구를 호출하거나 워크스페이스 credits를 사용해야 할 때만 열리므로, 로그인 전에 둘러보고 작업을 시작할 수 있습니다. 워크플로 모델은 Skills를 참고하세요.

에이전트가 할 수 있는 일

연결하면 에이전트가 UnifAPI 뒤에 있는 실시간 공개 데이터 작업에 접근할 수 있습니다. 다음과 같은 작업에 유용합니다:

• Twitter/X KOL 분석 및 인플루언서 후보 목록
• TikTok, YouTube, Instagram, Reddit 및 기타 지원 플랫폼 전반의 크리에이터 발굴
• 공개 게시물, 프로필, 댓글, 트렌드로부터의 경쟁사 모니터링
• 공개 소셜 신호로부터의 시장 조사
• 공개 LinkedIn 형식 데이터로부터의 리드 및 회사 강화

에이전트는 보통 원시 API 덤프가 아니라 브리프, 표, 후보 목록, 가격 범위 또는 후속 계획을 반환해야 합니다.

MCP로 노출되는 도구

UnifAPI는 세 개의 MCP 도구를 노출합니다. 모든 API 엔드포인트마다 별도의 MCP 도구를 등록하지 않습니다.

일반적인 에이전트 흐름:

고급: MCP 서버 URL & API 키 bearer

위 경로는 대부분의 클라이언트를 다룹니다. MCP를 직접 연결하거나, HTTP MCP 전송 위에 구축하거나, 명시적 설정이 필요한 클라이언트를 위해 연결을 제품화할 때 이 섹션을 사용하세요.

UnifAPI는 호스팅된 MCP 서버를 통해 공개 데이터 계층을 노출합니다:

https://mcp.unifapi.com

수동 MCP 설정

클라이언트가 플러그인 대신 원시 커넥터 URL을 받는다면, 호스팅된 서버를 직접 추가하세요.

Claude / Claude Desktop 커스텀 커넥터:

Customize -> Connectors -> + -> Add custom connector
Name: UnifAPI
URL: https://mcp.unifapi.com
Connect -> complete OAuth

Team 및 Enterprise 요금제의 경우, Owner가 먼저 Organization settings -> Connectors에서 커넥터를 추가하고, 멤버는 그런 다음 Customize -> Connectors에서 연결합니다. 구버전 로컬 전용 Claude Desktop 설정의 경우, mcp-remote가 claude_desktop_config.json을 통해 호스팅된 서버를 브리지할 수 있습니다:

{
  "mcpServers": {
    "unifapi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.unifapi.com"]
    }
  }
}

Claude Code CLI:

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

Codex CLI:

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

OpenClaw 원격 Streamable HTTP 서버:

openclaw mcp add unifapi \
  --url https://mcp.unifapi.com \
  --transport streamable-http \
  --auth oauth

openclaw mcp login unifapi
openclaw mcp doctor unifapi --probe

Hermes ~/.hermes/config.yaml:

mcp_servers:
  unifapi:
    url: "https://mcp.unifapi.com"
    auth: oauth

hermes mcp login unifapi

Cursor .cursor/mcp.json:

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

VS Code .vscode/mcp.json:

{
  "servers": {
    "unifapi": {
      "type": "http",
      "url": "https://mcp.unifapi.com"
    }
  }
}

기타 MCP 클라이언트 — 표준 서버 URL과 함께 Streamable HTTP를 사용하세요:

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

OAuth 세부 정보

UnifAPI의 MCP 서버는 OAuth 보호 리소스입니다.

보호 리소스 메타데이터는 호환 클라이언트에 어디에서 인가하고 어떤 scope가 필요한지 알려줍니다. OAuth 토큰에는 워크스페이스 claim이 포함되어 있어, 도구 호출은 직접 HTTP API 호출과 동일한 워크스페이스 credits를 사용합니다. OAuth는 UnifAPI를 인가하며, 사용자의 비공개 소스 계정에 대한 접근 권한은 부여하지 않습니다.

MCP 클라이언트가 명시적으로 지원하지 않는 한 클라이언트 설정에 커스텀 scope 필드를 추가하지 마세요. 호환 클라이언트는 보호 리소스 메타데이터를 발견하고 필수 scope를 요청해야 합니다.

API 키 bearer 대체 수단

클라이언트가 OAuth를 완료할 수 없거나 명시적으로 bearer 토큰/헤더를 요청할 때만 이것을 사용하세요. 위 OAuth 경로는 API 키가 필요하지 않습니다.

1. UnifAPI 대시보드에 로그인하세요.
2. API 키를 생성하세요.
3. MCP 클라이언트가 이를 authorization 헤더로 보내도록 설정하세요:

Authorization: Bearer YOUR_UNIFAPI_KEY

Cursor 스타일 JSON 예시:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com",
      "headers": {
        "Authorization": "Bearer YOUR_UNIFAPI_KEY"
      }
    }
  }
}

UnifAPI는 Authorization을 설정할 수 없는 클라이언트를 위해 X-API-Key와 X-UnifAPI-Key 헤더도 허용하지만, Authorization: Bearer ...가 권장됩니다.

과금 및 credits

MCP 호출은 HTTP 호출과 동일한 과금 모델을 사용합니다.

• MCP 서버 연결(및 skills 추가)은 무료입니다.
• call_api는 공개 데이터 작업을 호출할 때 워크스페이스 credits를 사용합니다.
• 과금 메타데이터는 작업 응답에 포함될 때 도구 결과에 반환됩니다.
• 워크스페이스에 credits가 남아 있지 않으면, 호출은 insufficient_credits로 실패합니다.

요청 제한은 속도 제한을, 공개 오류 어휘는 오류를 참고하세요.

문제 해결

클라이언트가 API 키를 요청함

위의 API 키 bearer 대체 수단을 사용하세요. 이것은 보통 클라이언트가 아직 OAuth 보호 리소스 디스커버리를 지원하지 않음을 의미합니다.

OAuth는 성공하지만 도구 호출이 실패함

OAuth 흐름이 MCP 리소스와 scope를 요청했는지 확인하세요:

• 리소스/오디언스: https://mcp.unifapi.com/
• Scope: unifapi:mcp

클라이언트가 토큰 교환 중에 리소스/오디언스를 보내지 않으면, MCP 보호 리소스가 검증할 수 없는 토큰을 받을 수 있습니다.

401 unauthorized

MCP 요청에 유효한 토큰이 없거나, OAuth 토큰이 이 리소스에 대해 유효하지 않거나, API 키 대체 토큰이 폐기되었거나 잘못 입력되었습니다.

insufficient_credits

OAuth 토큰 또는 API 키에 연결된 워크스페이스에 credits가 충분하지 않습니다. 대시보드에서 credits를 충전하고 다시 시도하세요.

도구 목록이 오래된 것으로 보임

MCP 클라이언트를 재시작하거나 다시 로드하세요. 일부 클라이언트는 서버 세션과 도구 목록을 캐시합니다.

관련 자료