JustOneAPI MCP Server

简体中文 | English

ChatGPT, Codex, Cursor, Hermes Agent 및 기타 AI 어시스턴트 도구와 같은 MCP 클라이언트에서 JustOneAPI를 사용하세요.

JustOneAPI MCP는 어시스턴트가 올바른 JustOneAPI 엔드포인트를 찾고, 필요한 매개변수를 확인하고, JustOneAPI 인증을 통해 API를 호출할 수 있도록 도와줍니다.

지원되는 클라이언트

JustOneAPI MCP는 원격 Streamable HTTP와 로컬 stdio를 지원합니다. 현재 검증된 경로 및 호환 경로는 다음과 같습니다:

• ChatGPT 웹 개발자 모드 MCP 연결: OAuth, 검증됨.

• Codex CLI 및 Codex IDE 확장: OAuth, 검증됨.

• Cursor, Hermes Agent 및 사용자 정의 헤더를 사용하는 기타 클라이언트: 기존 API 토큰 호환 방식.

• Claude.ai, Claude Desktop 및 Claude Code: OAuth는 호환성 테스트 중입니다. Claude Code는 기존 API 토큰 헤더를 사용할 수 있습니다.

호환되는 OAuth 등록 흐름을 갖춘 클라이언트는 원격 URL만으로 연결하고 브라우저에서 인증을 완료할 수 있습니다. 호환성은 클라이언트 등록 지원 및 계정 또는 워크스페이스 정책에 따라 달라집니다. OAuth를 지원하지 않는 클라이언트는 기존 API 토큰 헤더 또는 로컬 stdio를 계속 사용할 수 있습니다.

Related MCP server: MCP from API

빠른 시작

OAuth를 사용한 원격 HTTP

OAuth는 프로덕션 서비스에서 활성화되어 있습니다. 이 URL을 MCP 연결로 추가하세요:

https://mcp.justoneapi.com/mcp

호환 클라이언트는 보호된 리소스 메타데이터를 발견하고 auth.justoneapi.com으로 리디렉션한 다음 동의 페이지에 표시된 MCP 스코프를 요청합니다. 클라이언트에 JustOneAPI API 토큰을 붙여넣을 필요가 없습니다. 진입점, OAuth 등록 방법 및 계정 제한은 클라이언트마다 다르므로 아래 설정은 검증된 OAuth 경로만 나열합니다.

클라이언트 설정

• ChatGPT 웹: Settings → Security and login을 열고 Developer mode를 활성화한 다음 Plugins를 열고 +를 선택하세요. 이름, 설명 및 위의 /mcp URL을 입력한 다음 인증 방식으로 OAuth를 선택하세요. 연결을 생성한 후 ChatGPT는 인증 메타데이터를 발견하고 연결 중 또는 보호된 도구가 처음 호출될 때 인증을 시작합니다. 개발자 모드 사용 가능 여부는 ChatGPT 계정 및 워크스페이스 정책에 따라 달라질 수 있습니다.

• Codex CLI / IDE 확장: 아래 명령을 실행하세요. 현재 권장되는 설정은 검증된 DCR 등록 경로를 명시적으로 사용합니다:

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

codex mcp login justoneapi \
  --oauth-client-registration dcr

ChatGPT 데스크톱 앱, Codex CLI 및 Codex IDE 확장은 동일한 Codex 호스트에서 MCP 구성을 공유합니다. 현재 진입점은 OpenAI 공식 MCP 문서 및 ChatGPT 연결 테스트 가이드를 참조하세요.

Claude.ai, Claude Desktop 및 Claude Code용 OAuth는 호환성 테스트 중이며 아직 일반 지원 OAuth 연결로 제공되지 않습니다. Claude Code는 --header "Authorization: Bearer your_token"과 함께 기존 API 토큰을 사용할 수 있습니다. 아래의 일반적인 JSON을 Claude Code 구성으로 취급하지 마세요.

인증 페이지에는 요청된 스코프가 표시됩니다. 계정 소유자는 기존 API 토큰을 선택하거나 전용 토큰을 생성합니다. 토큰 멤버는 해당 멤버에게 할당된 토큰만 사용할 수 있습니다. 나중에 앱 연결을 해제하면 해당 OAuth 연결만 해지되며 연결된 API 토큰이 비활성화되거나 삭제되지는 않습니다.

기존 API 토큰을 사용한 원격 HTTP

기존 헤더 기반 연결은 호환성을 위해 계속 지원됩니다:

{
  "mcpServers": {
    "justoneapi": {
      "url": "https://mcp.justoneapi.com/mcp",
      "headers": {
        "Authorization": "Bearer your_token"
      }
    }
  }
}

로컬 stdio

2026-08-25 기준으로 npm latest는 여전히 레거시 1.0.1 패키지이며 이 저장소의 v2 구현이 아닙니다. 로컬 stdio가 필요하면 레거시 CLI가 호스팅된 v2 서비스로 오인되지 않도록 버전을 고정하세요:

{
  "mcpServers": {
    "justoneapi": {
      "command": "npx",
      "args": ["-y", "justoneapi-mcp@1.0.1"],
      "env": {
        "JUSTONEAPI_TOKEN": "your_token"
      }
    }
  }
}

레거시 1.0.1은 Node.js 18 이상을 지원하며 도구 구성은 호스팅된 v2 서비스와 동일하지 않습니다. OAuth는 원격 Worker에만 적용되며 stdio는 로컬에서 계속 JUSTONEAPI_TOKEN을 읽습니다. v2가 실제로 npm dist-tag에 게시된 후 이 버전 안내를 업데이트하세요.

카탈로그 빌드 및 동적 릴리스는 기본 제공 공공 안전 검증을 사용하며 운영자 보안 레지스트리나 비밀이 필요하지 않습니다. 런타임 API 및 계정 호출은 MCP 계층 응답 잘림 없이 업스트림 페이로드를 반환합니다.

인증 및 스코프

OAuth 사용자는 인증 페이지에서 연결할 API 토큰을 선택하며 클라이언트에 붙여넣지 않습니다. 기존 API 토큰 원격 호환 방식은 다음을 사용합니다:

Authorization: Bearer your_token

또는 로컬 stdio의 경우:

JUSTONEAPI_TOKEN=your_token

로컬 stdio는 위의 환경 변수를 사용합니다. 실제 토큰을 저장소에 커밋하지 마세요.

OAuth 액세스 토큰은 최소 권한의 세 가지 스코프를 사용합니다:

• mcp:catalog:read — 엔드포인트 검색, 스키마 확인, 플랫폼 나열.

• mcp:api:call — JustOneAPI 엔드포인트 호출.

• mcp:account:read — 잔액 및 사용량 확인.

call_endpoint는 OAuth 중 연결된 API 토큰과 해당 토큰의 현재 가격, 권한, 잔액 및 예산에 따라 요금이 발생할 수 있습니다. 이 함수는 단기 위임 토큰을 얻기 전에 엔드포인트와 매개변수를 검증한 다음 정확히 한 번의 업스트림 디스패치를 수행합니다. 불확실한 시간 초과, 네트워크 오류 또는 HTTP 502/503/504 결과에 대해 자동으로 재시도하지 않습니다.

레거시 API 토큰은 기존 쿼리/폼 형식으로 JustOneAPI 백엔드에 계속 전송됩니다. OAuth 액세스 및 위임 토큰은 백엔드 URL이나 폼 본문에 절대 포함되지 않으며, 위임 토큰은 Authorization Bearer 헤더로만 전송됩니다.

운영자 롤아웃

프로덕션은 현재 dual 모드로 실행됩니다. OAuth는 추가적이며 기능 플래그로 제어됩니다. 다음 스위치는 배포 및 롤백 경계로 유지됩니다:

• JUSTONEAPI_OAUTH_MODE=off는 원격 서비스를 레거시 전용으로 유지하고 OAuth 발견 메타데이터를 숨깁니다.

• JUSTONEAPI_OAUTH_MODE=dual은 정확한 https://mcp.justoneapi.com 오리진에서 기존 API 토큰과 표준 OAuth를 모두 허용합니다.

• Preview 및 workers.dev 라우트는 변수가 dual로 설정된 경우에도 레거시 전용으로 유지됩니다.

Worker는 인가 서버 인트로스펙션 및 RFC 8693 토큰 교환에 private_key_jwt를 사용합니다. 개인 JWK 세트와 활성 kid를 Worker 비밀로 저장하고 .dev.vars, PEM 파일 또는 개인 JWK 세트를 절대 커밋하지 마세요. 키를 교체하려면 먼저 이전 및 새 공개 키를 게시하고, 그다음 활성 kid를 전환하고, 중복 기간이 지난 후에만 폐기된 키를 제거하세요.

npm 2.0은 OIDC 신뢰 게시를 통해 먼저 next dist-tag로 게시됩니다. 정확히 게시된 아티팩트가 Node.js 20, 22, 24 스모크 검사를 통과한 후 운영자는 npm 2FA를 사용하여 npm dist-tag add justoneapi-mcp@2.0.0 latest로 별도로 승격합니다. 이 작업은 NPM_TOKEN으로 자동화되지 않습니다. RELEASE.md를 참조하세요.

물어볼 수 있는 것들

MCP 클라이언트에 자연스럽게 물어보세요:

Find the Xiaohongshu note comments API and tell me which parameters are required.

더 많은 예시:

Which Douyin APIs can get video details?

Call the Xiaohongshu note comments API with this note ID: xxxxx.

List the Weibo search-related APIs and explain when to use each one.

Continue to the next page of results.

Check my JustOneAPI balance.

Show my recent API usage and spending.

The API returned code 400. Help me check which parameter might be wrong.

The API returned code 601 or 602. What does it mean?

어시스턴트는 사용 가능한 JustOneAPI 엔드포인트를 검색하고, 필요한 매개변수를 설명하고, 필요한 값을 제공한 후 선택한 API를 호출하며, 일반적인 응답 코드를 해석하는 데 도움을 줄 수 있습니다.

라이선스

MIT