Cursor

Conecta la API de AstroWay a Cursor mediante MCP. Están disponibles los dos transportes: hosted (HTTP) y el paquete stdio local.

Requisitos previos

Obtén una clave API en el dashboard. Para hacer pruebas gratis usa una clave sandbox aw_test_*: no consume créditos.

Conexión

Edita ~/.cursor/mcp.json (o el .cursor/mcp.json del proyecto); también está disponible en Settings → MCP. Pega uno de los bloques siguientes y reinicia Cursor.

Hosted (HTTP): sin instalación, autenticación con un token Bearer:

~/.cursor/mcp.json

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

Stdio (npx): subproceso local, autenticación mediante una variable de entorno, funciona sin conexión:

~/.cursor/mcp.json

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

Verificación

Escríbele al agente en el chat: “Enumera las herramientas de Astroway”, o pídele que llame a una herramienta de referencia gratuita, por ejemplo obtener la lista de signos del zodíaco. Si recibes un resultado, la conexión funciona.

Solución de problemas

• 401 / invalid key: comprueba que la clave tiene el prefijo aw_live_* o aw_test_* y que no ha sido revocada. Puedes verificarlo en el dashboard.
• No aparecen las herramientas: reinicia Cursor por completo y comprueba la ruta de ~/.cursor/mcp.json (para el del proyecto, .cursor/mcp.json).
• Errores de validación -32602 (con stdio): actualiza el paquete: npm i @astroway/mcp@latest. Los esquemas se regeneran a partir de la especificación actual.

Todos los clientes: Configuración del agente.