Windsurf

Conecte o API AstroWay ao Windsurf através do MCP. O servidor utiliza o assistente Cascade.

Antecedentes

Obtenha a chave API no painel de controle. Para testes gratuitos, use a chave de sandbox aw_test_* - ela não desconta créditos.

Conexão

Edite ~/.codeium/windsurf/mcp_config.json; também está disponível através de Configurações → Cascade → MCP. Observe: para o servidor remoto Windsurf utiliza a chave serverUrl (não url). Insira um dos blocos abaixo e reinicie Windsurf.

Hosted (HTTP): sem instalação, autenticação através do token Bearer:

~/.codeium/windsurf/mcp_config.json

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

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

~/.codeium/windsurf/mcp_config.json

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

Verificação

Em Cascade, digite: «Liste os instrumentos Astroway» - ou peça para chamar o instrumento de referência gratuito, por exemplo, obtenha a lista dos signos do zodíaco. Se o resultado for retornado, a conexão está funcionando.

Resolução de problemas

• 401 / chave inválida: certifique-se de que a chave tenha o prefixo aw_live_* ou aw_test_* e não foi cancelada. Você pode verificar isso no painel de controle.
• Instrumentos não aparecem: reinicie Windsurf completamente e verifique o caminho ~/.codeium/windsurf/mcp_config.json (para hosted - a chave serverUrl).
• Erros de validação -32602 (para stdio): atualize o pacote: npm i @astroway/mcp@latest. As esquemas são recriados com a especificação atualizada.

Todos os clientes - Configuração do agente.