Claude Desktop

Conecte a API AstroWay ao Claude Desktop através do MCP: extensão de um clique ou manualmente através da configuração, com servidor hospedado (HTTP) ou pacote stdio local.

Pré-requisitos

Obtenha a sua chave de API no dashboard. Para testes gratuitos, utilize a chave de sandbox aw_test_* - esta não consome créditos.

Extensão de um clique

1. Descarregue astroway.mcpb.
2. Abra o ficheiro. O Claude Desktop mostrará um diálogo de instalação.
3. Insira a sua chave de API, selecione os grupos de ferramentas (por predefinição: mapas natais, trânsitos, progressões, retornos, sinastria e calendário) e ative a extensão.

Não é necessário editar a configuração. A extensão é um pacote npm @astroway/mcp com as suas dependências, compilado a partir do mesmo lançamento. Limpe o campo de grupos para carregar todos os 700+ ferramentas.

Conexão manual

Abra Settings → Developer → Edit Config - o Claude Desktop mostrará o caminho para o ficheiro claude_desktop_config.json. Insira um dos blocos abaixo e reinicie o Claude Desktop.

Hosted (HTTP): sem o nosso pacote, autenticação via token Bearer. A configuração do Claude Desktop só executa comandos locais e ignora o registo com o próprio url, por isso o servidor hosted conecta-se através da ponte mcp-remote:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer aw_live_YOUR_KEY" }
  }
}
}

A chave está em env, não em args, porque o Claude Desktop no Windows quebra o argumento nos espaços após Bearer. Para carregar um único tema em vez de todo o catálogo, substitua /mcp por um servidor de domínio, por exemplo /mcp/core ou /mcp/vedic.

Stdio (npx): subprocesso local, autenticação através de variável de ambiente, funciona offline:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "@astroway/mcp"],
    "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
  }
}
}

Verificação

Escreva para o Claude na conversa: “Liste as ferramentas Astroway” - ou peça para chamar uma ferramenta de referência gratuita, por exemplo, obter uma lista dos signos do zodíaco. Se receber uma resposta, a conexão está a funcionar.

Solução de problemas

• 401 / chave inválida: certifique-se de que a chave tem o prefixo aw_live_* ou aw_test_* e não foi revogada. Pode verificar no dashboard.
• “Some MCP servers couldn’t be loaded”: no registo está url em vez de command. Use o bloco com mcp-remote acima.
• As ferramentas não aparecem: reinicie completamente o Claude Desktop (saia, não apenas feche a janela) e verifique o caminho para claude_desktop_config.json.
• Erros de validação -32602 (para stdio): atualize o pacote: npm i @astroway/mcp@latest. Os schemas são regenerados a partir da especificação atual.

Todos os clientes - Configuração do agente.