Conectar o Weave ao Claude

URL do conectorCopy Anchor Link

Use o endpoint Streamable HTTP (não /sse):

https://<API_HOST>/api/v1/mcp

Exemplo: https://api.weave.gaelgomes.me/api/v1/mcp

Essa rota não fica em /api/public. O public API é REST com tokens wn_; o MCP usa Streamable HTTP + OAuth (ou Bearer wn_ / wmo_).

Claude.ai (conector personalizado)Copy Anchor Link

1. Em Configurações → Conectores → Adicionar conector personalizado, informe a URL acima.
2. O Claude descobre OAuth automaticamente (401 + metadata em /.well-known/...).
3. Autorize no Weave: escolha workspace e escopos (a tela mostra quais tools esses escopos liberam).
4. Volte ao Claude — o conector deve aparecer conectado.

O Weave implementa OAuth 2.1 com DCR + PKCE (S256). Não use a rota legada /api/v1/mcp/sse neste formulário.

Escopos → toolsCopy Anchor Link

Na autorização você escolhe escopos de API (notes:read, ai:chat, …). Em runtime o MCP filtra tools cujo tool.scopes intersecta esses escopos. Não há grant por tool individual.

Deploy checklist (CORS / cookies)Copy Anchor Link

Para o fluxo authorize (API) → login/consent (web) funcionar:

1. CORS_PRODUCTION_ALLOWED_ORIGINS (ou CORS_ALLOWED_ORIGINS) inclui a origem do web (ex.: https://weave.gaelgomes.me).
2. Cookie de sessão compartilha domínio pai: AUTH_COOKIE_DOMAIN ou .${WEB_DOMAIN} (ex.: .gaelgomes.me).
3. API_URL / MCP_OAUTH_ISSUER apontam para o host público da API (sem barra final; path MCP = /api/v1/mcp).
4. Não adicione claude.ai ao CORS — o Claude fala server-to-server com o MCP (sem Origin).

Claude Desktop / API token estáticoCopy Anchor Link

1. Em Weave → Settings → API tokens, crie um token wn_… com os escopos desejados.
2. Configure o MCP com Bearer:

{
  "mcpServers": {
    "weave": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<API_HOST>/api/v1/mcp",
        "--header",
        "Authorization: Bearer wn_SEU_TOKEN"
      ]
    }
  }
}

Se a organização Claude tiver Request headers (beta), use a mesma URL e o header Authorization: Bearer wn_….

Segurança na contaCopy Anchor Link

Em Settings → Account você pode:

• ver e revogar sessões web ativas
• ver e revogar conexões MCP OAuth (grants wmo_)

Rotas relacionadasCopy Anchor Link