Cursor

Liga a API AstroWay ao Cursor 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.

Ligação

Edita o ~/.cursor/mcp.json (ou o .cursor/mcp.json do projeto); também está disponível em Settings → MCP. Cola um dos blocos abaixo e reinicia o Cursor.

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

~/.cursor/mcp.json

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

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

~/.cursor/mcp.json

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

Verificação

Escreve ao agente no chat: «Lista as ferramentas Astroway» – ou pede para chamar 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 painel.
• Ferramentas não aparecem: reinicia completamente o Cursor e verifica o caminho para ~/.cursor/mcp.json (para o projeto – .cursor/mcp.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.