Server MCP: Usa AstroAPI dagli Assistenti IA

AstroAPI offre un server Model Context Protocol (MCP) in hosting. Collegalo a un assistente IA come Claude Code, Claude Desktop o Cursor, e l'assistente potrà chiamare AstroAPI direttamente — cercare luoghi di nascita, calcolare temi e spiegare i risultati in linguaggio semplice.

Questo è anche il modo più veloce per costruire un'integrazione: collega il server MCP al tuo assistente di programmazione IA e chiedigli di scrivere il codice di integrazione per te. L'assistente può effettuare chiamate API reali mentre lavora, quindi vede risposte effettive invece di tirare a indovinare.

Nessun codice richiesto

Una volta collegato, puoi semplicemente chiedere al tuo assistente cose come "Calcola il tema natale di una persona nata il 15 giugno 1990 alle 14:30 ad Amsterdam" — l'assistente risolve la località, chiama l'API e riassume il risultato.

---

Endpoint

https://mcp.astroapi.cloud/mcp

• Trasporto: Streamable HTTP
• Autenticazione: la tua normale chiave AstroAPI, inviata nell'header X-Api-Key
• I moduli, i limiti di frequenza e le quote del tuo abbonamento si applicano esattamente come per le chiamate API dirette.

Puoi creare una chiave API nella dashboard sotto API Keys. Consulta Autenticazione per i dettagli.

---

Collegare Claude Code

Esegui questo comando una volta nel terminale:

claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

Poi chiedi semplicemente a Claude Code di usare AstroAPI — per esempio: "Usa gli strumenti astroapi per calcolare un tema natale per il 1990-06-15 14:30 ad Amsterdam e costruiscimi un componente React che lo visualizzi."

Collegare Cursor

Aggiungi questo a .cursor/mcp.json nel tuo progetto (o a ~/.cursor/mcp.json a livello globale):

{
  "mcpServers": {
    "astroapi": {
      "url": "https://mcp.astroapi.cloud/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Collegare altri client MCP

Funziona qualsiasi client che supporti MCP su Streamable HTTP con header personalizzati. Configura:

Impostazione	Valore
URL	https://mcp.astroapi.cloud/mcp
Trasporto	Streamable HTTP
Header	X-Api-Key: YOUR_API_KEY

Client in hosting senza header personalizzati

Alcuni client in hosting (come i connettori web di claude.ai) non possono inviare header personalizzati e richiedono OAuth. Il supporto OAuth è nella roadmap; per ora, usa un client che supporti gli header personalizzati, come Claude Code, Claude Desktop o Cursor.

---

Strumenti Disponibili

Strumento	Cosa fa
astro_resolve_place	Cerca il nome di un luogo e restituisce le coordinate e il fuso orario IANA. Gli assistenti sono istruiti a chiamare prima questo strumento, così non indovinano mai le coordinate.
astro_natal_chart	Calcola un tema natale (punti, case, aspetti), opzionalmente con testi interpretativi, e restituisce un riepilogo compatto e leggibile.

Altri strumenti (transiti, sinastria, compatibilità, fasi lunari, immagini dei temi e altri) sono in arrivo. La disponibilità degli strumenti segue i moduli del tuo abbonamento: uno strumento non incluso nel tuo piano restituisce un messaggio chiaro invece dei dati.

---

Sessione di Esempio

Una conversazione con un assistente collegato potrebbe assomigliare a questa:

Tu: Qual è il segno solare e l'ascendente di una persona nata il 3 marzo 1985 alle 6:45 a Barcellona?

Assistente: chiama astro_resolve_place con "Barcelona", poi astro_natal_chart con le coordinate e il fuso orario risolti — Il Sole è in Pesci a 12°41′ nella 1ª casa, e l'Ascendente è Acquario 28°10′ …

L'assistente gestisce la geocodifica, la conversione del fuso orario e la chiamata API — le cose che di solito vanno storte quando si inseriscono i dati di nascita a mano.

---

Prossimi Passi

• Autenticazione — creare e gestire le chiavi API
• Per Iniziare — le basi dell'API dietro questi strumenti
• Temi Natali — cosa restituisce il calcolo natale