Claude Code

Conecta la API de AstroWay a Claude Code a través de MCP. No es necesario editar archivos, todo se configura con un solo comando en la terminal.

Requisitos previos

Obtén tu clave API en el panel de control. Para pruebas gratuitas, usa la clave sandbox aw_test_*, no consume créditos.

Conexión

Ejecuta uno de los comandos en la terminal. Después de esto, reinicia Claude Code.

Hosted (HTTP): sin instalación, autenticación a través de token Bearer:

terminal

claude mcp add --transport http astroway https://mcp.astroway.info/mcp \
--header "Authorization: Bearer aw_live_YOUR_KEY"

Stdio (npx): subproceso local, autenticación a través de variable de entorno, funciona sin conexión:

terminal

claude mcp add astroway --env ASTROWAY_API_KEY=aw_live_YOUR_KEY -- npx -y @astroway/mcp

Verificación

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

Solución de problemas

• 401 / invalid key: asegúrate de que la clave tenga el prefijo aw_live_* o aw_test_* y que no haya sido revocada. Puedes verificarlo en el panel de control.
• Las herramientas no aparecen: reinicia completamente Claude Code y verifica que el servidor haya sido añadido (claude mcp list).
• 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.