Iniziare con Aktionariat MCP

Questa pagina spiega come connettere il server MCP Aktionariat AI al client di tua scelta. L’URL del server è lo stesso ovunque:

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

Gli strumenti pubblici (elenchi di token, book degli ordini) funzionano subito dopo la connessione. Per sbloccare gli strumenti personali (portafoglio, rapporti fiscali) o gli strumenti emittente (registro degli azionisti, proposte), chiama lo strumento sign_in all’interno del tuo client e autentica con il PIN inviato alla tua email Aktionariat.

1. Aggiungi il Connettore

Claude

1. Apri claude.ai e vai a Settings → Connectors.

   In Claude Desktop, apri Settings → Connectors — apparirà la stessa finestra di dialogo.

2. Fai clic su Add custom connector.

3. Incolla l’URL del server MCP:

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

4. Conferma il connettore. Claude apre la finestra di dialogo OAuth di Aktionariat — per l’accesso pubblico di sola lettura puoi chiuderla; per l’accesso personale inserisci la tua email Aktionariat per ricevere un PIN.

5. Gli strumenti Aktionariat ora appaiono in qualsiasi nuova conversazione nel menu dei connettori.

ChatGPT

1. Apri chatgpt.com e vai a Settings → Connectors (attualmente in rollout per i workspace Plus, Pro, Team, Enterprise ed Edu).

2. Fai clic su Add connector → Custom MCP server.

3. Incolla l’URL del server MCP:

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

4. Approva il connettore. ChatGPT ti guida attraverso OAuth — inserisci la tua email Aktionariat per ricevere un PIN quando desideri sbloccare gli strumenti personali.

5. In una nuova chat, abilita il connettore Aktionariat dal menu degli strumenti e inizia a porre domande sulle aziende tokenizzate.

Claude Code

1. Installa Claude Code se non l’hai già fatto.

2. Aggiungi il server MCP Aktionariat dalla riga di comando:

   claude mcp add --transport http aktionariat https://mcp.ai.aktionariat.com/mcp

3. Avvia (o riavvia) Claude Code. Gli strumenti Aktionariat sono ora disponibili in qualsiasi sessione.

4. Esegui /mcp all’interno di Claude Code per confermare la connessione e attivare il flusso OAuth quando desideri accedere per gli strumenti personali.

2. Verifica la Connessione

Fai una domanda pubblica che non richieda l’accesso. L’agente dovrebbe chiamare list_tokens e restituire le aziende onboarded manualmente su Aktionariat.

Claude

Apri una nuova conversazione, assicurati che il connettore Aktionariat sia abilitato e chiedi:

List the tokenized companies on Aktionariat.

ChatGPT

Apri una nuova chat, abilita il connettore Aktionariat dal menu degli strumenti e chiedi:

List the tokenized companies on Aktionariat.

Claude Code

Nella tua sessione di terminale, chiedi:

List the tokenized companies on Aktionariat.

Se vedi una tabella di token con ticker, nomi degli emittenti e indirizzi dei contratti, il connettore funziona.

3. Accedi per gli Strumenti Personali

Gli strumenti personali (portfolio, request_tax_report, my_secondary_market_orders) e gli strumenti emittente (shareholder_registry, list_proposals, …) richiedono una sessione autenticata.

Claude

1. Chiedi a Claude di “sign me in to Aktionariat” — chiamerà lo strumento sign_in.

2. Claude riapre la finestra di dialogo OAuth di Aktionariat. Inserisci l’indirizzo email che usi su Aktionariat.

3. Controlla quella email per un PIN. Digita il PIN nella finestra di dialogo per completare l’accesso.

4. Riprova l’azione che richiedeva l’autenticazione — Claude ora ha una sessione personale e può chiamare gli strumenti personali per tuo conto.

ChatGPT

1. Chiedi a ChatGPT di “sign me in to Aktionariat” — chiamerà lo strumento sign_in.

2. ChatGPT riapre la finestra di dialogo OAuth di Aktionariat. Inserisci l’indirizzo email che usi su Aktionariat.

3. Controlla quella email per un PIN. Digita il PIN nella finestra di dialogo per completare l’accesso.

4. Riprova l’azione che richiedeva l’autenticazione — ChatGPT ora ha una sessione personale e può chiamare gli strumenti personali per tuo conto.

Claude Code

1. Esegui /mcp in Claude Code e scegli Authenticate per il server Aktionariat, oppure chiedi semplicemente all’assistente di “sign me in to Aktionariat”.

2. Claude Code apre una scheda del browser con la finestra di dialogo OAuth di Aktionariat. Inserisci la tua email Aktionariat.

3. Controlla quella email per un PIN e completa l’accesso nella scheda del browser.

4. Torna al terminale — la sessione è ora autenticata e gli strumenti personali sono disponibili.

Passare da un account a un altro

Chiamare sign_in di nuovo ripristina la sessione corrente. La prossima chiamata dello strumento attiva un nuovo flusso OAuth, che è il modo canonico per passare da un account a un altro o per effettuare il logout.

4. Prova Alcuni Prompt

Alcuni punti di partenza, per pubblico:

Come membro del pubblico

• “What tokenized companies are on Aktionariat?”
• “What is the current order book for DAKS?”
• “Who is the issuer behind the DAKS token?”

Come investitore autenticato

• “Show me my portfolio.”
• “List my open secondary-market orders for Aktionariat AG.”
• “Send me my 2025 tax report as a PDF.”

Come amministratore emittente

• “Which companies can I manage?”
• “Show me the top 50 shareholders for my company.”
• “Export my shareholder registry as XLSX as of today.”
• “List the pending multisig proposals for my company and start signing the most recent one.”

Per il riferimento completo degli strumenti e i prompt di esempio che ogni strumento può rispondere, vedi le pagine per singolo strumento sotto Guides.