VS Code

Conecte a API AstroWay ao VS Code através do MCP. A configuração é lida pelo Copilot Chat no modo Agente.

Pré-requisitos

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

Conexão

Crie .vscode/mcp.json na raiz do projeto. Note: no VS Code, a chave é servers (não mcpServers), e cada servidor precisa do campo type. Insira um dos blocos abaixo e reinicie o VS Code.

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

.vscode/mcp.json

{
"servers": {
  "astroway": {
    "type": "http",
    "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:

.vscode/mcp.json

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

Verificação

No Copilot Chat (modo Agente), escreva: «Liste as ferramentas da AstroWay» - ou peça para chamar uma ferramenta de referência gratuita, por exemplo, para obter a lista dos signos do zodíaco. Se receber um resultado em resposta, a conexão está funcionando.

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.
• Ferramentas não aparecem: reinicie completamente o VS Code e verifique o caminho .vscode/mcp.json (chave servers, campo type).
• Erros de validação -32602 (para stdio): atualize o pacote: npm i @astroway/mcp@latest. Os esquemas são regenerados a partir da especificação atual.

Todos os clientes - Configuração do agente.