Claude Desktop

Conecta la API AstroWay a Claude Desktop mediante MCP. Están disponibles ambos transportes: hosted (HTTP) y local stdio-paquete.

Antecedentes

Obtén la API-key en el panel de control. Para la prueba gratuita, utiliza la clave de sandbox aw_test_* - no se cobrará crédito.

Conexión

Abre Configuración → Desarrollador → Editar Config - Claude Desktop mostrará el camino al archivo claude_desktop_config.json. Inserta uno de los bloques a continuación y reinicia Claude Desktop.

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

claude_desktop_config.json

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

Stdio (npx): proceso local, autenticación mediante variable de entorno, funciona en línea:

claude_desktop_config.json

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

Verificación

Escribe en el chat de Claude: «Listar herramientas de Astroway» - o pide que llame al herramienta de referencia gratuita, por ejemplo, obtenga la lista de signos del zodíaco. Si obtienes un resultado, la conexión funciona.

Solución de problemas

• 401 / clave inválida: asegúrate de que la clave tenga el prefijo aw_live_* o aw_test_* y no ha sido revocada. Puedes verificarlo en el panel de control.
• Las herramientas no aparecen: reinicia completamente Claude Desktop (cierra la aplicación, no solo el ventana) y verifica el camino al archivo claude_desktop_config.json.
• Errores de validación -32602 (para stdio): actualiza el paquete: npm i @astroway/mcp@latest. Las esquemas se regeneran con la especificación actualizada.

Todos los clientes - Configuración del agente.