voltarAthelium · docs
Suporte técnico
Documentação

MCP

Conecte qualquer ferramenta compatível com Model Context Protocol e tenha o contexto curado disponível como tool dentro da IDE ou chat.

Pré-requisitos

  • API key da empresa (peça à curadoria) — ou login de cliente, no caso do claude.ai
  • Ferramenta MCP suportada: claude.ai (web), Claude Desktop, Cursor, Continue, Zed, Windsurf
  • URL do gateway (ex: https://gateway.athelium.com.br/mcp)

claude.ai (web) — via OAuth

No claude.ai não é preciso API key. O acesso usa OAuth: você autoriza com o seu login de cliente e pode revogar quando quiser.

  1. No claude.ai: Settings → Connectors → Add custom connector
  2. URL: https://gateway.athelium.com.br/mcp (deixe Client ID e Secret em branco)
  3. O claude.ai abre a página de autorização do Athelium — entre com seu login de cliente e clique em Autorizar

Requer plano pago do claude.ai (Pro, Max, Team ou Enterprise) e um usuário de cliente no Athelium vinculado à sua empresa.

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\\Claude\\claude_desktop_config.json (Windows) e adicione:

claude_desktop_config.jsonjson
{
  "mcpServers": {
    "athelium": {
      "url": "https://gateway.athelium.com.br/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer <sua_api_key>"
      }
    }
  }
}

Reinicie o Claude Desktop. A skill aparece como ferramenta compose_context.

Cursor

Settings → Cursor Settings → MCP → Edit. Mesma estrutura do Claude Desktop:

~/.cursor/mcp.jsonjson
{
  "mcpServers": {
    "athelium": {
      "url": "https://gateway.athelium.com.br/mcp",
      "headers": {
        "Authorization": "Bearer <sua_api_key>"
      }
    }
  }
}

Continue

Edite ~/.continue/config.json:

.continue/config.jsonjson
{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "streamable-http",
          "url": "https://gateway.athelium.com.br/mcp",
          "options": {
            "headers": {
              "Authorization": "Bearer <sua_api_key>"
            }
          }
        }
      }
    ]
  }
}

Testar com MCP Inspector

Para validar a conexão e inspecionar tools/resources antes de configurar numa ferramenta de uso diário:

terminalbash
npx @modelcontextprotocol/inspector \
  --transport http \
  --url https://gateway.athelium.com.br/mcp \
  --header "Authorization: Bearer <sua_api_key>"

Tools disponíveis

compose_context
(intent: string)

Devolve o contexto curado relevante ao intent, estruturado e com proveniência. Use o resultado como contexto pra qualquer LLM.

serve_answeropt-in
(question: string)

Devolve resposta direta a partir do contexto curado, sem precisar de outro LLM. Opcional — habilitada sob demanda pela curadoria por empresa.

Resources disponíveis

Cada skill ativa do tenant é exposta como um resource navegável:

text
skills://nicho/<nicho_id>/<slug>
skills://empresa/<empresa_id>/<slug>

A ferramenta MCP pode listar (resources/list) e ler (resources/read) cada skill como markdown.

Troubleshooting

  • Tool não aparece após reiniciar — confirme caminho do config (macOS vs Windows), JSON válido (sem vírgula sobrando) e que reiniciou completamente o aplicativo.
  • 401 missing/invalid api key — verifique o header Authorization: Bearer <sua_api_key> no config. Detalhes em autenticação.
  • 429 rate limited — limite e comportamento em erros & limites.
  • Tool call timeout — compose pode levar até 60s no cold start. A ferramenta MCP precisa estar configurada pra esperar.
  • Tool retornou sem skills — o intent pode não ter cobertura no contexto curado. Reescreva com mais especificidade ou reporte à curadoria.

Próximos passos