Ganter Lab
로그인 다운로드

클라이언트 연결

Claude, Codex, Gemini CLI, GitHub Copilot, 그리고 그 밖의 모든 MCP 클라이언트를 위한, 그대로 복사해 쓰는 설정.

Markdown으로 보기

클라이언트 연결 카드는 지원하는 클라이언트를 하나씩 안내하며, 설정한 포트가 이미 담겨 있어 그대로 복사해 쓸 수 있는 예시를 내놓습니다(아래 예시는 기본값인 18181을 씁니다). 로컬 클라이언트는 모두 터널 없이 엔드포인트에 곧바로 접속합니다.

Claude

Claude Chat(데스크톱 앱)과 Claude Code(CLI 또는 데스크톱 앱)는 설정이 따로입니다. 한쪽을 연결해도 다른 쪽은 연결되지 않습니다.

  • Claude Chat(데스크톱 앱): 가장 간단한 길입니다. 한 번 눌러 설치하는 MCP 번들(.mcpb)이 앱에 함께 담겨 있습니다. Claude Desktop에 설치를 누르고(파일을 남겨 두려면 다른 이름으로 저장…), Claude Desktop에서 설치 대화 상자를 확인하십시오. 이 번들은 Claude의 stdio 전송에서 이 스테이션의 HTTP 엔드포인트로 이어 주는 아주 작은 로컬 다리를 담고 있으며, 그것이 필요로 하는 Node 실행 환경은 Claude Desktop이 함께 가지고 있습니다. 포트를 바꿨다면 설치 대화 상자에서 엔드포인트를 같은 값으로 맞추십시오.
  • Claude Code(CLI 또는 데스크톱 앱): 터미널 명령 하나입니다.
claude mcp add --transport http ganterlab http://127.0.0.1:18181/mcp

Codex (CLI / IDE)

Codex는 루프백 엔드포인트에 Streamable HTTP 서버로 곧바로 접속합니다. codex mcp add 명령은 stdio 서버만 다루므로, HTTP 형태는 ~/.codex/config.toml에 적습니다.

[mcp_servers.ganterlab]
url = "http://127.0.0.1:18181/mcp"

Gemini CLI

Gemini CLI는 ~/.gemini/settings.json의 httpUrl 서버 형식으로 접속합니다. (Gemini 웹 대화에는 터널 없이 로컬로 닿는 길이 없어서 CLI만 제공합니다.)

{
  "mcpServers": {
    "ganterlab": {
      "httpUrl": "http://127.0.0.1:18181/mcp"
    }
  }
}

GitHub Copilot

길은 둘이며, 최상위 키가 서로 다릅니다.

  • VS Code: .vscode/mcp.json에 서버를 더한 다음(또는 명령 팔레트에서 "MCP: Open User Configuration"을 실행한 다음), Copilot Chat의 도구 선택기에서 그것을 켜십시오.
{
  "servers": {
    "ganterlab": {
      "type": "http",
      "url": "http://127.0.0.1:18181/mcp"
    }
  }
}
  • CLI: ~/.copilot/mcp-config.json의 mcpServers 아래에 같은 서버 모양을 적습니다(또는 CLI 안에서 /mcp add를 실행하고 HTTP 서버 형식을 고르십시오).

클라우드를 거치는 클라이언트는 지원하지 않습니다

ChatGPT의 커넥터와 Gemini 웹 대화, 그리고 인터넷에서 스테이션에 닿는 그 밖의 모든 것은 이 엔드포인트를 쓸 수 없으며, 페이지도 그것을 위한 설정을 내놓지 않습니다. 엔드포인트는 Host 헤더가 로컬이 아닌 요청을 세션 핸드셰이크 전에 거부하므로 터널도 도움이 되지 않습니다. 터널은 자기 공개 호스트를 그대로 전달하는데, 그것이 바로 거부되는 것입니다. 스테이션은 에이전트를 위해 네트워크에 공개되지 않으며, 그렇게 만드는 스위치도 없습니다.

그 밖의 모든 MCP 클라이언트

이 컴퓨터에서 실행되고 HTTP MCP 서버 URL을 받는 클라이언트라면 무엇이든 이 스테이션을 쓸 수 있습니다. 페이지에 나오는 엔드포인트로 그 클라이언트를 향하게 하십시오.