Claude Desktop

Conectați API-ul AstroWay la Claude Desktop prin MCP. Sunt disponibile ambele transporturi: hosted (HTTP) și pachetul stdio local.

Precondiții

Obțineți cheia API din dashboard. Pentru testare gratuită, folosiți cheia sandbox aw_test_* - aceasta nu consumă credite.

Conectare

Deschideți Settings → Developer → Edit Config - Claude Desktop va afișa calea către fișierul claude_desktop_config.json. Inserați unul dintre blocurile de mai jos și reporniți Claude Desktop.

Hosted (HTTP): fără pachetul nostru, autentificare prin Bearer token. Configurația Claude Desktop pornește doar comenzi locale și sări peste intrarea cu url de sine stătător, deci serverul hosted se conectează prin podul 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" }
  }
}
}

Cheia se află în env, nu în args, deoarece Claude Desktop pe Windows desparte argumentul pe spații după Bearer. Pentru a încărca un singur subiect în locul întregului catalog, înlocuiți /mcp cu serverul de domeniu, de exemplu /mcp/core sau /mcp/vedic.

Stdio (npx): subproces local, autentificare prin variabilă de mediu, funcționează offline:

claude_desktop_config.json

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

Verificare

Scrieți în chat cu Claude: “Enumeră uneltele Astroway” - sau cereți să apelați un instrument de referință gratuit, de exemplu pentru a obține lista semnelor zodiacale. Dacă primiți un răspuns, conexiunea funcționează.

Depanare

• 401 / invalid key: asigurați-vă că cheia are prefixul aw_live_* sau aw_test_* și nu a fost revocată. Puteți verifica în dashboard.
• “Some MCP servers couldn’t be loaded”: în intrarea url în loc de command. Folosiți blocul cu mcp-remote de mai sus.
• Uneltele nu apar: reporniți complet Claude Desktop (ieșiți, nu doar închideți fereastra) și verificați calea către claude_desktop_config.json.
• Erori de validare -32602 (pentru stdio): actualizați pachetul: npm i @astroway/mcp@latest. Schemele sunt regenerate din specificația actuală.

Toți clienții - Configurare agent.