Salta ai contenuti

Panoramica

Aktionariat AI è un server Model Context Protocol (MCP) ospitato che espone la piattaforma Aktionariat di azioni tokenizzate a qualsiasi agente IA. Una volta connesso, un client compatibile con MCP — Claude, ChatGPT, Claude Code, Cursor e altri — può rispondere a domande su aziende tokenizzate, leggere dati di mercato dal vivo, gestire portafogli utente ed eseguire workflow di emittenti, tutto basato sulle stesse API che alimentano aktionariat.com e l’app Aktionariat Portfolio.

Il server si trova all’indirizzo:

https://mcp.ai.aktionariat.com/mcp

La superficie dello strumento è divisa in tre livelli, controllata da ciò per cui l’utente si è autenticato.

Accesso in sola lettura ai dati già pubblici sulla piattaforma Aktionariat.

  • Scopri le aziende tokenizzate onboarded manualmente (list_tokens, get_token).
  • Leggi il libro degli ordini del mercato secondario attuale per qualsiasi token onboarded (order_book).

Una volta che l’utente effettua l’accesso (un flusso PIN una tantum all’interno del client MCP), l’agente può agire per suo conto.

  • Leggi il profilo dell’utente connesso (person).
  • Leggi le sue partecipazioni attuali (portfolio).
  • Elenca i suoi ordini di acquisto e vendita sul mercato secondario (my_secondary_market_orders).
  • Richiedi un rapporto fiscale, generato in modo asincrono e inviato via email all’utente (request_tax_report).

Strumenti per emittenti — Accesso come amministratore aziendale

Sezione intitolata “Strumenti per emittenti — Accesso come amministratore aziendale”

Se l’utente connesso è autorizzato a gestire una o più aziende, diventa disponibile un set aggiuntivo di strumenti.

  • Elenca le aziende che l’utente può gestire (list_managed_companies).
  • Leggi i principali detentori del registro degli azionisti di un’azienda gestita (shareholder_registry).
  • Genera un’esportazione completa del registro come file scaricabile (export_shareholder_registry).
  • Elenca e firma proposte multisig (list_proposals, sign_proposal).

Alcune scelte modellano il comportamento del server — vale la pena conoscerle prima di connettere un agente.

Ogni strumento che modifica qualcosa di sensibile (firmare una transazione, esportare dati personali) richiede un’azione esplicita dell’utente nel client MCP o una conferma di follow-up nell’app mobile Aktionariat. L’agente stesso non detiene mai fondi o chiavi di firma.

Gli strumenti che toccano dati personali restituiscono riepiloghi snelli e adatti ai modelli — indirizzi email, ID interni e campi inutilizzati vengono eliminati prima che la risposta raggiunga il modello. I dati completi sono disponibili, ma solo tramite download di file che bypassa completamente il contesto del modello (vedi export_shareholder_registry).

Gli strumenti pubblici dei token sono controllati da una lista di permessi. I token che non sono stati onboarded manualmente sono trattati come inesistenti. Questo mantiene il modello onesto su ciò che la piattaforma supporta effettivamente.

Tutti gli strumenti chiamano lo stesso backend che serve l’app web Aktionariat e l’app Portfolio. Non c’è un indice separato, nessuna staleness, nessun percorso dati parallelo.

Qualsiasi client che parla MCP remoto su HTTP funziona. Questa documentazione si concentra su tre:

  • Claude (web claude.ai e Claude Desktop) — tramite connettori personalizzati.
  • ChatGPT — tramite il sistema Apps & Connectors.
  • Claude Code — tramite claude mcp add.

Cursor, Continue, Cline e qualsiasi altro client consapevole di MCP accettano lo stesso URL tramite i rispettivi file di configurazione. La pagina Inizia illustra i passaggi esatti per ciascuno.

  • Nuovo al connettore? Inizia con Inizia con Aktionariat MCP.
  • Vuoi il comportamento, gli input e i prompt di esempio di un singolo strumento? Vedi le pagine per singolo strumento sotto Guide.
  • Cerchi il sito del prodotto canonico? ai.aktionariat.com è la pagina di destinazione pubblica.