From 66e9efe0188847a82324625069084bca010204ca Mon Sep 17 00:00:00 2001 From: nitai Date: Wed, 11 Nov 2026 18:06:31 -0300 Subject: [PATCH] docs(gobus-mcp): conectar o Claude Code com type http em /mcp, sem barra final MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A página do módulo mandava usar "transport": "http" com a URL .../mcp/. O Claude Code usa a chave "type", e com a barra final o servidor responde 307. Separa as abas Claude Code (claude mcp add --transport http) e Claude Desktop / claude.ai (conector remoto), avisa que o /sse foi removido do servidor e renomeia a entrada stdio para gobus-local. Co-Authored-By: Claude Opus 5.5 --- docs/modulos/gobus-mcp.md | 30 ++++++++++++++++++++++++------ 1 file changed, 24 insertions(+), 6 deletions(-) diff --git a/docs/modulos/gobus-mcp.md b/docs/modulos/gobus-mcp.md index 20ec365..be19324 100644 --- a/docs/modulos/gobus-mcp.md +++ b/docs/modulos/gobus-mcp.md @@ -53,34 +53,52 @@ O Gobus MCP é a interface de IA do Destaques Gov.BR: | Camada | Tecnologia | |--------|-----------| | Protocolo | FastMCP 3.x (MCP) | -| Transport | stdio (local) · HTTP streamable-http (Cloud Run) | +| Transport | stdio (local) · Streamable HTTP stateless em `/mcp` (Cloud Run) | | Cliente GraphQL | httpx async | | Config | pydantic-settings (prefixo `GOBUS_`) | | Deploy | Cloud Run, env vars via Terraform | ## Conectar ao servidor -=== "Claude Desktop / Code" +=== "Claude Code" - Adicione ao `.mcp.json` do projeto ou ao settings global: + ```bash + claude mcp add --transport http gobus https://destaquesgovbr-gobus-mcp-klvx64dufq-rj.a.run.app/mcp -s user + ``` + + O comando grava no `~/.claude.json` (ou use o mesmo bloco no `.mcp.json` do projeto): ```json { "mcpServers": { "gobus": { - "transport": "http", - "url": "https://destaquesgovbr-gobus-mcp-klvx64dufq-rj.a.run.app/mcp/" + "type": "http", + "url": "https://destaquesgovbr-gobus-mcp-klvx64dufq-rj.a.run.app/mcp" } } } ``` + A chave é `type` (não `transport`) e a URL vai **sem barra final**: `/mcp/` responde 307. Confira com `claude mcp get gobus` ("Connected"). + + O endpoint `/sse` foi removido do servidor em novembro de 2026. Se a sua config ainda tem `"type": "sse"` em `.../sse`, remova a entrada (`claude mcp remove gobus -s `) e rode o `claude mcp add` acima. + +=== "Claude Desktop / claude.ai" + + Adicione um conector remoto (custom connector) com a URL: + + ``` + https://destaquesgovbr-gobus-mcp-klvx64dufq-rj.a.run.app/mcp + ``` + === "Local (stdio)" + Para desenvolver o servidor; o nome `gobus-local` evita colisão com o `gobus` remoto. + ```json { "mcpServers": { - "gobus": { + "gobus-local": { "command": "python", "args": ["-m", "gobus_mcp"], "env": {