Claude Desktop

Conecta la API AstroWay a Claude Desktop a través de MCP: con una extensión de un clic o manualmente mediante configuración, con un servidor hosted (HTTP) o con un paquete stdio local.

Requisitos previos

Obtén la clave API en el dashboard. Para pruebas gratuitas usa la clave sandbox aw_test_* - no consume créditos.

Extensión de un clic

1. Descarga astroway.mcpb.
2. Abre el archivo. Claude Desktop mostrará el diálogo de instalación.
3. Pega la clave API, selecciona los grupos de herramientas (por defecto cartas natales, tránsitos, progresiones, retornos, sinastría y calendario) y habilita la extensión.

No es necesario editar la configuración. La extensión es el paquete npm @astroway/mcp con sus dependencias, compilado desde la misma versión. Vacía el campo de grupos para cargar los 700+ herramientas.

Conexión manual

Abre Settings → Developer → Edit Config - Claude Desktop mostrará la ruta al archivo claude_desktop_config.json. Inserta uno de los bloques a continuación y reinicia Claude Desktop.

Hosted (HTTP): sin nuestro paquete, autenticación mediante token Bearer. La configuración de Claude Desktop solo ejecuta comandos locales y omite la entrada con el propio url, por lo que el servidor hosted se conecta a través del puente mcp-remote:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer aw_live_YOUR_KEY" }
  }
}
}

La clave está en env, no en args, porque Claude Desktop en Windows divide el argumento en el espacio después de Bearer. Para cargar un tema en lugar de todo el catálogo, reemplaza /mcp por el servidor de dominio, por ejemplo /mcp/core o /mcp/vedic.

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

claude_desktop_config.json

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

Verificación

Escribe a Claude en el chat: “Enumera las herramientas Astroway” - o pide invocar una herramienta de referencia gratuita, por ejemplo obtener la lista de signos del zodiaco. Si recibes un resultado, la conexión funciona.

Resolución de problemas

• 401 / invalid key: asegúrate de que la clave tenga el prefijo aw_live_* o aw_test_* y no esté revocada. Puedes verificarlo en el dashboard.
• “Some MCP servers couldn’t be loaded”: en la entrada url en lugar de command. Usa el bloque con mcp-remote de arriba.
• Herramientas no aparecen: reinicia completamente Claude Desktop (cierra sesión, no solo cierra la ventana) y verifica la ruta a claude_desktop_config.json.
• Errores de validación -32602 (para 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.