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:

bash

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):

json

{
  "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.
`astro_synastry`	Confronta due temi di nascita ed elenca gli aspetti tra i due temi in entrambe le direzioni.
`astro_composite`	Calcola un tema composito (dei punti medi) della relazione, con posizioni e aspetti propri.
`astro_transits`	Trova i transiti su un tema natale in un periodo (fino a 2 anni): date di inizio, esattezza e fine per ogni aspetto.
`astro_compatibility`	Punteggio rapido di compatibilità tra due persone in base al segno solare.
`astro_solar_return`	Il tema di rivoluzione solare per un dato anno (il tema astrologico del compleanno).
`astro_lunar_return`	Il tema di rivoluzione lunare a partire da una data specifica (all'incirca mensile).
`astro_progressions`	Progressioni secondarie per una data obiettivo, inclusi gli aspetti con il tema natale.
`astro_human_design`	Un bodygraph completo di Human Design: tipo, strategia, autorità, profilo, centri, canali e porte.
`astro_moon_sun`	Fase lunare più orari di sorgere/tramonto, mezzogiorno solare e crepuscoli per una data e un luogo.
`astro_moon_calendar`	Report giornaliero (segno, fase, luna vuota di corso) o una panoramica di un periodo con fasi, cambi di segno e periodi di vuoto di corso.
`astro_retrograde_calendar`	Periodi di retrogradazione con date di stazionamento, segni attraversati e periodi d'ombra.
`astro_chinese_horoscope`	Segno ed elemento dello zodiaco cinese, oppure una previsione annuale.
`astro_numerology`	Il profilo numerologico completo a partire dalla data di nascita e dal nome, oppure solo il numero del percorso di vita.
`astro_numerology_compatibility`	Compatibilità tra due persone in base ai loro numeri del percorso di vita.
`astro_horoscope`	Report di oroscopo già redatti: giornaliero, settimanale, annuale e annuale per ascendente.
`astro_ai_summary`	Scrive un breve riepilogo di ciò che significa un oroscopo, a partire dalle posizioni e dagli aspetti più forti. Richiede il modulo AI Summary.

Altri strumenti (astrocartografia, 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

Server MCP: Usa AstroAPI dagli Assistenti IA ​

Endpoint ​

Collegare Claude Code ​

Collegare Cursor ​

Collegare altri client MCP ​

Strumenti Disponibili ​

Sessione di Esempio ​

Prossimi Passi ​