Windsurf

Liga a API AstroWay ao Windsurf via MCP. O servidor é usado pelo assistente Cascade.

Pré-requisitos

Obtém uma chave de API no dashboard. Para testar gratuitamente, usa uma chave sandbox aw_test_*: não debita créditos.

Ligação

Edita ~/.codeium/windsurf/mcp_config.json; também está acessível em Settings → Cascade → MCP. Atenção: para um servidor remoto, o Windsurf usa a chave serverUrl (não url). Cola um dos blocos abaixo e reinicia o Windsurf.

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

~/.codeium/windsurf/mcp_config.json

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

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

No Cascade, escreve: “Lista as ferramentas da Astroway”, ou pede para chamar uma ferramenta de referência gratuita, por exemplo obter a lista de signos do zodíaco. Se receberes um resultado, a ligação está a funcionar.

Resolução de problemas

• 401 / invalid key: confirma que a chave tem o prefixo aw_live_* ou aw_test_* e que não foi revogada. Podes verificá-lo no dashboard.
• As ferramentas não aparecem: reinicia o Windsurf por completo e verifica o caminho ~/.codeium/windsurf/mcp_config.json (para hosted, a chave serverUrl).
• Erros de validação -32602 (em stdio): atualiza o pacote com npm i @astroway/mcp@latest. Os schemas são regenerados a partir da especificação atual.

Todos os clientes: Configuração do agente.