Claude Desktop

Conecta a API AstroWay ao Claude Desktop através do MCP. Ambos os transportes estão disponíveis: hosted (HTTP) e o pacote stdio local.

Pré-requisitos

Obtém a chave API no painel. Para testes gratuitos usa a chave sandbox aw_test_* – ela não consome créditos.

Conexão

Abre Settings → Developer → Edit Config – o Claude Desktop mostrará o caminho para o ficheiro claude_desktop_config.json. Cola um dos blocos abaixo e reinicia o Claude Desktop.

Hosted (HTTP): sem instalação, autenticação via token Bearer:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "url": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Stdio (npx): subprocesso local, autenticação via 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

Escreve ao Claude no chat: «Lista as ferramentas Astroway» – ou pede para invocar uma ferramenta de referência gratuita, por exemplo obter a lista dos signos do zodíaco. Se receberes um resultado na resposta, a conexão está a funcionar.

Resolução de problemas

• 401 / invalid key: certifica‑te de que a chave tem o prefixo aw_live_* ou aw_test_* e não está revogada. Podes verificar no painel.
• Ferramentas não aparecem: reinicia completamente o Claude Desktop (sai da aplicação, não apenas fecha a janela) e verifica o caminho para claude_desktop_config.json.
• Erros de validação -32602 (para stdio): atualiza o pacote: npm i @astroway/mcp@latest. Os esquemas são regenerados a partir da especificação mais recente.

Todos os clientes – Configuração do agente.