Il server MCP di Fincanva

Dov’è il server MCP, e quale trasporto usa?

Il server è in https://app.fincanva.com/mcp. Usa Streamable HTTP, senza stato e con risposte JSON: ogni richiesta è un POST, e GET e DELETE rispondono HTTP 405, perché non c’è un flusso di eventi da aprire né una sessione da chiudere.

Quali strumenti serve il server MCP?

Ogni strumento è un’operazione, con il nome del suo id, lo stesso schema di input, lo stesso risultato e gli stessi codici di errore del suo endpoint REST; il Riferimento le documenta una per una. tools/list risponde con le operazioni delle famiglie che il tuo piano include.

Per ogni app collegata, l’utente può disattivare delle famiglie nelle Impostazioni di Fincanva, in App collegate, oppure mettere l’app in sola lettura: riceve allora solo gli strumenti con readOnlyHint vero, che leggono, analizzano e simulano ma non creano né modificano niente nella libreria, e una chiamata a qualsiasi altro risponde toolset_disabled. Una modifica arriva all’app al suo tools/list successivo.

Che cosa riceve un client quando si collega?

All’initialize il server risponde con instructions: una presentazione di che cos’è Fincanva, di che cosa rende possibile ogni famiglia elencata e di come si combinano gli strumenti, scritta esattamente per gli strumenti che il client riceve. Uno strumento il cui risultato può contenere un grafico rimanda alla risorsa UI ui://fincanva/chart, che un client capace di mostrare le risorse UI di MCP può visualizzare.

Come si autentica un client MCP?

Con un token di accesso OAuth 2.1 che porta lo scope fincanva.research, trovato attraverso i documenti di discovery in Autenticazione e chiavi API. Una chiave API viene rifiutata su MCP con HTTP 401: una chiave funziona solo via REST.