---
title: "Il server MCP di Fincanva"
description: "Il server MCP di Fincanva: l’indirizzo, il trasporto Streamable HTTP, uno strumento per operazione, che cosa riceve un client al collegamento e come accede."
canonical_url: "https://fincanva.com/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva"
last_updated: "2026-10-11"
md_url: "https://fincanva.com/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva.md"
---

# Il server MCP di Fincanva

Il server MCP di Fincanva serve le operazioni di Fincanva come strumenti a un client AI, attraverso il Model Context Protocol. Ogni strumento è la stessa operazione che l’Open API serve via REST.

## 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](/it/sviluppatori/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](/it/sviluppatori/open-api/autenticazione-e-chiavi-api). Una chiave API viene rifiutata su MCP con HTTP 401: una chiave funziona solo via REST.

Fincanva ha uno scopo solo educativo e illustrativo: non è una consulenza finanziaria personalizzata, e i risultati passati o simulati non indicano quelli futuri. [Leggi l'Addendum ai Termini](https://fincanva.com/it/terms/addendum#section-3)