Integrations Overview
You can connect many existing SDKs, coding tools, and agent frameworks to GoRoute by changing the endpoint and credential they use. Most integrations do not need a new application flow. Choose the guide for your client below, then use the protocol details when you need to troubleshoot a connection.
GoRoute supports OpenAI-compatible (/v1/*, /openai/v1/*) and Anthropic-compatible (/anthropic/v1/*, /v1/messages) endpoints, along with MCP (/mcp*) and A2A (/a2a/v1/*) protocols.
Base URLs by Protocol
| Client Ecosystem | Base URL | Supported Endpoints | Reference |
|---|---|---|---|
| OpenAI-Compatible | http://localhost:8080/v1 | /v1/chat/completions, /v1/completions, /v1/embeddings, /v1/responses, /v1/realtime, /v1/models, /v1/audio/*, /v1/images/*, /v1/files, /v1/batches, /v1/rerank, /v1/moderations | Gateway API |
| OpenAI Direct Alias | http://localhost:8080/openai/v1 | /openai/v1/responses, /openai/v1/realtime | Responses API |
| Anthropic-Compatible | http://localhost:8080/anthropic | /anthropic/v1/messages, /anthropic/v1/messages/count_tokens (also mounted at /v1/messages and /v1/messages/count_tokens) | Anthropic Messages |
| Model Context Protocol (MCP) | http://localhost:8080/mcp | /mcp, /mcp/{serverSlug}, /mcp/toolsets/{toolsetSlug}, /mcp-rest/tools/* | MCP Overview |
| Agent-to-Agent (A2A) | http://localhost:8080/a2a/v1 | /.well-known/agent-card.json, /a2a/v1/agents/{agentSlug}/, /a2a/v1/agents/{agentSlug}/tasks* | A2A Overview |
Authentication with Virtual Keys (sk-gw-...)
Data-plane routes authenticate callers using Virtual Keys prefixed with sk-gw- (issued via the Operator UI at /ui/ or POST /admin/v1/keys). See Virtual Keys for key creation, RBAC scoping, and budget caps.
GoRoute accepts either standard credential header:
Authorization: Bearer sk-gw-...(OpenAI-compatible clients)x-api-key: sk-gw-...(Anthropic-compatible clients)
[!NOTE] If a client sends both
Authorization: Bearer ...andx-api-key: ...with different values, GoRoute rejects the request with400 Bad Request(ambiguous_gateway_credentials). Identical values in both headers are accepted.
Integration Guides
Coding Agents & IDEs
- Claude Code: Route Claude Code through
/anthropicusingANTHROPIC_BASE_URLandANTHROPIC_AUTH_TOKENorANTHROPIC_API_KEY. - Cursor, Continue & Cline: Configure IDE extensions against
/v1with Virtual Keys and unified model aliases. - Codex CLI, Gemini CLI & OpenWebUI: Connect terminal coding agents and self-hosted chat UIs via
/v1.
Official Language SDKs & Agent Frameworks
- OpenAI SDKs (Python & TypeScript): Chat completions, SSE streaming, embeddings, Responses API, and Realtime WebSockets.
- Anthropic SDKs (Python & TypeScript): Native
/anthropic/v1/messagesand/anthropic/v1/messages/count_tokens. - Agent Frameworks: LangChain, OpenAI Agents SDK, and Google ADK with GoRoute MCP and A2A endpoints.
Observability & Telemetry
- OpenTelemetry & Prometheus: OTLP/HTTP span export (
tracing.otlp_endpoint,gen_ai.*attributes, W3Ctraceparent) and Prometheus/metricsscraping.