Claude Code

Liga a API AstroWay ao Claude Code através do MCP. Não precisas editar ficheiros - tudo é configurado com um único comando no terminal.

Pré-requisitos

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

Ligação

Executa um dos comandos no terminal. Depois disso, reinicia o Claude Code.

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

terminal

claude mcp add --transport http astroway https://mcp.astroway.info/mcp \
--header "Authorization: Bearer aw_live_YOUR_KEY"

Stdio (npx): subprocess local, autenticação via variável de ambiente, funciona offline:

terminal

claude mcp add astroway --env ASTROWAY_API_KEY=aw_live_YOUR_KEY -- npx -y @astroway/mcp

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, a ligaçã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 dashboard.
• Ferramentas não aparecem: reinicia completamente o Claude Code e verifica se o servidor foi adicionado (claude mcp list).
• 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.