MCP 서버

Sakuranbo AI의 MCP 서버를 사용하면 코딩 에이전트가 이 문서를 검색하고, 모델 카탈로그를 조회하고, 요청 비용을 계산하고, 잔액과 이용 내역을 읽을 수 있습니다. 서버 URL은 https://api.sakuranbo.ai/mcp이며 Streamable HTTP 전송을 사용합니다.

모든 도구는 읽기 전용입니다. 이 서버로는 콘텐츠를 생성하거나, 잔액을 사용하거나, 계정을 변경할 수 없습니다.

서버에 대한 모든 요청에는 인증이 필요합니다. 문서와 모델 도구도 마찬가지입니다. OAuth로 로그인하거나 API 키를 Bearer 토큰으로 보냅니다. 유효한 토큰이 없는 요청은 401을 반환합니다.

• search_docs: 이 문서를 검색합니다.
• get_doc: 문서의 한 페이지를 Markdown으로 읽습니다.
• list_models: 모달리티나 작업으로 필터링해 모델을 나열합니다.
• get_model: 모델 하나의 입력 파라미터와 가격을 읽습니다.
• estimate_cost: 요청을 실행하기 전에 비용을 계산합니다.
• get_balance: 선불 잔액을 읽습니다.
• get_usage: 기간별 사용량을 읽습니다.
• list_requests: 최근 요청을 나열합니다.
• list_jobs: 이미지·동영상 생성 작업을 나열합니다.
• get_job: 생성 작업 하나를 읽습니다.

클라이언트는 기본적으로 OAuth로 로그인합니다. 브라우저가 열리면 대시보드에 로그인하고 접근을 승인합니다. 자세한 내용은 로그인과 권한을 참조하세요. 아래 각 클라이언트에는 API 키를 대신 사용하는 설정도 함께 실었습니다. API 키로 연결도 참조하세요.

claude mcp add --transport http sakuranbo https://api.sakuranbo.ai/mcp

그런 다음 Claude Code에서 /mcp를 실행하고, 브라우저의 안내에 따라 로그인합니다. API 키를 대신 사용하려면 다음과 같이 합니다.

claude mcp add --transport http sakuranbo https://api.sakuranbo.ai/mcp \
  --header "Authorization: Bearer $SAKURANBO_API_KEY"

프로젝트의 .cursor/mcp.json에 서버를 추가합니다. 모든 프로젝트에서 사용하려면 ~/.cursor/mcp.json에 추가합니다. Cursor는 OAuth로 로그인합니다.

{
  "mcpServers": {
    "sakuranbo": {
      "url": "https://api.sakuranbo.ai/mcp"
    }
  }
}

API 키를 대신 사용하려면 다음과 같이 합니다.

{
  "mcpServers": {
    "sakuranbo": {
      "url": "https://api.sakuranbo.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SAKURANBO_API_KEY}"
      }
    }
  }
}

워크스페이스의 .vscode/mcp.json에 서버를 추가합니다. 명령 팔레트에서 MCP: Add Server를 실행하고 HTTP를 선택한 뒤 서버 URL을 입력할 수도 있습니다. VS Code가 로그인을 요청하면 브라우저에서 절차를 마칩니다.

{
  "servers": {
    "sakuranbo": {
      "type": "http",
      "url": "https://api.sakuranbo.ai/mcp"
    }
  }
}

API 키를 대신 사용하면 서버를 시작할 때 VS Code가 키 입력을 요청하며, 키는 파일에 기록되지 않습니다.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sakuranbo-api-key",
      "description": "Sakuranbo AI API key",
      "password": true
    }
  ],
  "servers": {
    "sakuranbo": {
      "type": "http",
      "url": "https://api.sakuranbo.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sakuranbo-api-key}"
      }
    }
  }
}

~/.codex/config.toml에 서버를 추가합니다.

[mcp_servers.sakuranbo]
url = "https://api.sakuranbo.ai/mcp"

그런 다음 codex mcp login sakuranbo를 실행해 로그인합니다. API 키를 대신 사용하려면 환경 변수 SAKURANBO_API_KEY를 설정하고 bearer_token_env_var를 추가합니다.

[mcp_servers.sakuranbo]
url = "https://api.sakuranbo.ai/mcp"
bearer_token_env_var = "SAKURANBO_API_KEY"

클라이언트를 처음 연결할 때의 흐름입니다.

1. 클라이언트가 브라우저를 엽니다.
2. 로그인하지 않았다면 Sakuranbo AI 대시보드에 로그인합니다.
3. 동의 화면에 클라이언트와 요청하는 접근 권한이 표시됩니다. ’허용’을 선택합니다.

클라이언트가 스스로 등록하므로 OAuth 앱을 만들거나 클라이언트 ID를 복사할 필요가 없습니다.

허용하는 권한은 account:read 하나뿐입니다. 클라이언트는 잔액, 사용량, 요청과 작업의 이력을 읽을 수 있습니다. 콘텐츠를 생성하거나 잔액을 사용할 수는 없습니다.

클라이언트가 브라우저를 열 수 없거나 CI에서 연결할 때는 API 키를 사용합니다. 위의 예처럼 Authorization 헤더에 Bearer 토큰으로 키를 보냅니다.

API 키는 cherry_로 시작합니다. 서버는 cherry_로 시작하는 토큰을 항상 API 키로 검증하며, OAuth 토큰으로는 취급하지 않습니다.

키는 대시보드의 API 키 페이지에서 만듭니다. 키를 커밋하는 파일에 쓰지 말고 SAKURANBO_API_KEY 같은 환경 변수에서 읽으세요.

대시보드의 API 키 페이지를 엽니다. ’연결된 앱(MCP)’에서 앱의 ’연결 해제’를 선택하고 확인하면 1분 정도 안에 해당 앱의 접근이 끝납니다. API 키로 연결했다면 대신 키의 ’폐기’를 선택합니다. 폐기한 키는 다음 요청부터 거부됩니다.