Podłączanie Claude Code i Codex

Claude Code i Codex mogą używać GoModel jako jednego uwierzytelnionego endpointu MCP. Otrzymują narzędzia udostępniane przez GoModel, a dane uwierzytelniające do Linear, GitHub i innych upstreamowych serwerów MCP pozostają w GoModel. Claude Code or Codex -> GoModel /mcp -> upstream MCP servers

Zanim zaczniesz

Potrzebujesz:

Działającego wdrożenia GoModel, z którym klient może się połączyć.
Co najmniej jednego podłączonego serwera MCP w dashboardzie lub konfiguracji GoModel.
Klucza głównego GoModel albo zarządzanego klucza uwierzytelniającego, który ma dostęp do tego serwera.

Ustaw dane uwierzytelniające klienta w swojej powłoce:

export GOMODEL_API_KEY="sk-your-gomodel-key"

Dla zdalnego wdrożenia używaj HTTPS. Dla lokalnego procesu GoModel zastąp przykładowy URL adresem http://localhost:8080/mcp.

Z klienta wysyłaj tylko klucz GoModel. Tokeny upstreamowe, takie jak klucz API Linear, skonfiguruj w ustawieniach serwera MCP w GoModel.

Wybierz endpoint

Endpoint	Katalog udostępniany klientowi
`https://gomodel.example.com/mcp`	Każdy serwer widoczny dla klucza, z nazwami takimi jak `linear_create_issue`
`https://gomodel.example.com/mcp/linear`	Tylko Linear, z oryginalnymi nazwami narzędzi
`https://gomodel.example.com/mcp/github`	Tylko GitHub, z oryginalnymi nazwami narzędzi

Zagregowany endpoint /mcp to zwykle właściwy wybór. Endpoint dla pojedynczego serwera przydaje się, gdy jeden agent powinien otrzymać mniejszy katalog.

Claude Code

Dodaj GoModel jako serwer Streamable HTTP w scope użytkownika:

claude mcp add \
  --transport http \
  --scope user \
  gomodel \
  https://gomodel.example.com/mcp \
  --header "Authorization: Bearer ${GOMODEL_API_KEY}"

Sprawdź zapisane połączenie:

claude mcp list
claude mcp get gomodel

Uruchom Claude Code i wpisz /mcp, aby sprawdzić połączenie i dostępne narzędzia.

Nie trzymaj klucza we współdzielonym pliku

Przy konfiguracji w scope projektu utwórz .mcp.json w katalogu głównym projektu. Claude Code rozwija zmienne środowiskowe w URL-ach i nagłówkach:

{
  "mcpServers": {
    "gomodel": {
      "type": "http",
      "url": "https://gomodel.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${GOMODEL_API_KEY}"
      }
    }
  }
}

Plik można udostępniać bez klucza. Każdy użytkownik eksportuje GOMODEL_API_KEY lokalnie i zatwierdza projektowy serwer MCP, gdy Claude Code o to poprosi. Scope konfiguracji i dodatkowe polecenia zarządzania opisuje oficjalna dokumentacja MCP w Claude Code.

Codex

Codex może odczytać token bearer ze zmiennej środowiskowej bez zapisywania jego wartości w konfiguracji MCP:

codex mcp add gomodel \
  --url https://gomodel.example.com/mcp \
  --bearer-token-env-var GOMODEL_API_KEY

Sprawdź zapisane połączenie:

codex mcp list

Uruchom Codex i wpisz /mcp, aby sprawdzić serwer i jego narzędzia. Codex CLI i rozszerzenie IDE współdzielą tę konfigurację MCP. Równoważny wpis w ~/.codex/config.toml to:

[mcp_servers.gomodel]
url = "https://gomodel.example.com/mcp"
bearer_token_env_var = "GOMODEL_API_KEY"

Polityki zatwierdzania, filtry narzędzi i konfigurację w scope projektu opisuje oficjalna dokumentacja MCP w Codex.

Ograniczanie zagregowanego katalogu

Aby zachować URL /mcp i jednocześnie wybrać podzbiór upstreamowych serwerów, wysyłaj nagłówek X-MCP-Servers z rozdzielonymi przecinkami slugami serwerów. W Claude Code dodaj go obok Authorization w .mcp.json:

"headers": {
  "Authorization": "Bearer ${GOMODEL_API_KEY}",
  "X-MCP-Servers": "linear,github"
}

W Codex dodaj statyczny nagłówek:

[mcp_servers.gomodel]
url = "https://gomodel.example.com/mcp"
bearer_token_env_var = "GOMODEL_API_KEY"
http_headers = { "X-MCP-Servers" = "linear,github" }

Nieznane slugi w X-MCP-Servers są ignorowane. GoModel nadal stosuje widoczność według user_path klucza uwierzytelniającego oraz filtry dozwolonych/niedozwolonych narzędzi każdego serwera.

Rozwiązywanie problemów

Objaw	Co sprawdzić
`401 Unauthorized`	Czy `GOMODEL_API_KEY` jest wyeksportowany i zawiera prawidłowy klucz GoModel
Połączono, ale brak narzędzi	`user_path` klucza, ustawienia widoczności serwera oraz filtry dozwolonych/niedozwolonych narzędzi
Serwer ma stan degraded	Otwórz jego katalog w dashboardzie, sprawdź ostatni błąd, a następnie użyj Reconnect
Ostatni błąd to `no MCP endpoint at that path` (starsze release’y: `session not found` podczas początkowego połączenia)	Czy `url` serwera zawiera ścieżkę jego endpointu MCP, na przykład `/http` dla mcp-devtools lub `/v2/mcp` dla Firecrawl
Ostatni błąd wspomina `HTTP 405 Method Not Allowed`	Czy `transport` serwera pasuje do endpointu: `http` dla streamable HTTP, `sse` tylko dla starszych serwerów SSE
Działa lokalnie, ale nie zdalnie	Publiczny URL, certyfikat TLS, firewall i przekazywanie `/mcp` przez reverse proxy

GoModel używa uwierzytelniania bearer zamiast interaktywnego przepływu OAuth dla swojego endpointu MCP udostępnianego klientom. Nie uruchamiaj codex mcp login gomodel; skonfiguruj token bearer tak, jak pokazano wyżej. Zachowanie proxy, konfigurację upstreamów, cykl życia i kwestie bezpieczeństwa opisuje strona MCP Gateway.

Pierwsze kroki

Funkcje

Funkcje Pro

MCP Proxy

Zaawansowane

O GoModel

Podłączanie Claude Code i Codex

Zanim zaczniesz

Wybierz endpoint

Claude Code

Nie trzymaj klucza we współdzielonym pliku

Codex

Ograniczanie zagregowanego katalogu

Rozwiązywanie problemów

​Zanim zaczniesz

​Wybierz endpoint

​Claude Code

​Nie trzymaj klucza we współdzielonym pliku

​Codex

​Ograniczanie zagregowanego katalogu

​Rozwiązywanie problemów

Zanim zaczniesz

Wybierz endpoint

Claude Code

Nie trzymaj klucza we współdzielonym pliku

Codex

Ograniczanie zagregowanego katalogu

Rozwiązywanie problemów