MCP 사용 방법

00시작하기 전에

ByOrbit는 원격 MCP 서버(Streamable HTTP)입니다. 인증은 발급받은 API 키를 URL 쿼리(?key=)에 붙여 사용합니다. 아래 모든 예시의 발급받은_키 부분을 본인 키로 바꿔주세요.

https://mcp.brownskin.kr/api/mcp

https://mcp.brownskin.kr/api/mcp?key=발급받은_키

⚠️ API 키는 비밀번호와 같습니다. 공개 저장소·채팅에 노출하지 마세요. 유출 시 발급 페이지 또는 info@brownskin.kr 로 폐기·재발급 요청하세요.

01Claude (웹 · 데스크톱) — 커스텀 커넥터

1. Claude 우측 하단/설정에서 설정 → 커넥터(Connectors)로 이동합니다.
2. 커스텀 커넥터 추가(Add custom connector)를 클릭합니다.
3. 이름에 ByOrbit, 원격 MCP 서버 URL에 아래 커넥터 URL을 붙여넣습니다.
4. 추가 후 대화에서 도구 아이콘으로 ByOrbit을 활성화하면 식품·영양 도구를 사용할 수 있습니다.

https://mcp.brownskin.kr/api/mcp?key=발급받은_키

커스텀 커넥터는 Claude Pro/Team/Enterprise 등에서 제공됩니다. 키가 URL에 포함돼 있어 별도 인증(OAuth) 설정은 필요 없습니다.

02Claude Desktop — 설정 파일

커넥터 UI 대신 설정 파일로 추가할 수도 있습니다. claude_desktop_config.json에 아래를 추가하고 Claude Desktop을 재시작하세요.

• • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "byorbit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.brownskin.kr/api/mcp?key=발급받은_키"]
    }
  }
}

mcp-remote는 원격 HTTP MCP를 데스크톱 앱에 연결해주는 브리지입니다. Node.js(npx)가 설치돼 있어야 합니다.

03Claude Code (CLI)

터미널에서 HTTP 트랜스포트로 한 줄로 추가합니다.

claude mcp add --transport http byorbit "https://mcp.brownskin.kr/api/mcp?key=발급받은_키"

추가 후 확인 · 사용:

claude mcp list          # 등록된 MCP 서버 확인
claude mcp get byorbit   # 상세 보기
# 대화 중 /mcp 로 도구 활성화 상태를 확인할 수 있습니다

04ChatGPT — 개발자 모드 앱(커넥터)

1. 설정 → 앱 및 커넥터(Apps & Connectors)로 이동합니다.
2. 고급 설정에서 개발자 모드(Developer mode)를 켭니다.
3. 앱 만들기 / 커넥터 만들기(Create)를 선택합니다.
4. 이름 ByOrbit, MCP 서버 URL에 아래 커넥터 URL을 입력하고 인증 방식은 인증 없음(No authentication)으로 둡니다. (키가 URL에 포함됨)
5. 생성 후 대화 입력창의 + → 앱에서 ByOrbit을 선택해 사용합니다.

https://mcp.brownskin.kr/api/mcp?key=발급받은_키

개발자 모드 커넥터는 ChatGPT Plus/Pro/Business 등에서 제공되며, 베타 기능이라 메뉴 명칭이 버전에 따라 다를 수 있습니다.

05Codex CLI

~/.codex/config.toml에 MCP 서버를 등록합니다. mcp-remote 브리지를 사용하는 방식이 가장 호환성이 높습니다.

[mcp_servers.byorbit]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.brownskin.kr/api/mcp?key=발급받은_키"]

최신 Codex가 원격 HTTP를 직접 지원한다면 아래처럼 URL만 지정할 수도 있습니다.

[mcp_servers.byorbit]
url = "https://mcp.brownskin.kr/api/mcp?key=발급받은_키"

06기타 에이전트 CLI (Gemini · Antigravity · agy 등)

대부분의 에이전트 CLI는 표준 MCP 설정(JSON) 또는 mcp-remote 브리지를 지원합니다. 도구의 MCP 설정 파일에 아래 형식을 넣으면 됩니다.

{
  "mcpServers": {
    "byorbit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.brownskin.kr/api/mcp?key=발급받은_키"]
    }
  }
}

원격 URL을 직접 받는 클라이언트라면 https://mcp.brownskin.kr/api/mcp?key=발급받은_키 를 그대로 입력하세요. 설정 파일 경로와 키 이름(mcpServers / mcp_servers / servers)은 도구마다 다를 수 있으니 해당 도구 문서를 함께 확인하세요.

07연결 확인 · 문제 해결

터미널에서 아래 명령으로 키와 서버가 정상인지 바로 확인할 수 있습니다. 도구 목록(search_food 등)이 나오면 정상입니다.

curl -X POST "https://mcp.brownskin.kr/api/mcp?key=발급받은_키" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

해결되지 않으면 info@brownskin.kr 로 문의해 주세요.