---
title: "L’Open API di Fincanva"
description: "L’Open API e il server MCP di Fincanva espongono le stesse operazioni: come invocarne una via REST o MCP, e dove ogni operazione ha la sua pagina."
canonical_url: "https://fincanva.com/it/sviluppatori/open-api/l-open-api-di-fincanva"
last_updated: "2026-10-03"
md_url: "https://fincanva.com/it/sviluppatori/open-api/l-open-api-di-fincanva.md"
---

# L’Open API di Fincanva

L’Open API di Fincanva e il server MCP di Fincanva espongono le stesse operazioni: ciascuna è un endpoint REST e uno strumento MCP con lo stesso nome, gli stessi parametri, lo stesso risultato e gli stessi limiti di piano. Un client AI le chiama come strumenti; il tuo codice le chiama via HTTPS. Ogni cifra che restituiscono porta la propria unità, e la pagina delle convenzioni spiega che cosa significano ogni unità e ogni segno.

## Come si invoca un’operazione di Fincanva?

- Via REST, invia `POST` a `https://app.fincanva.com/api/v1/research/<operation_id>` con i parametri in un corpo JSON e una credenziale — una chiave API o un token di accesso OAuth, come descrive [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api).
- Via MCP, aggiungi `https://app.fincanva.com/mcp` a un client MCP; ogni operazione è uno strumento con il nome del suo id, e il client accede con OAuth.
- Il documento OpenAPI 3.1 di tutte le operazioni REST si trova in `https://app.fincanva.com/api/v1/research/openapi.json`.
- Ogni operazione risponde con [la struttura del risultato](/it/sviluppatori/concetti/la-struttura-del-risultato), e un errore porta uno dei [codici di errore](/it/sviluppatori/open-api/gli-errori-dell-open-api-di-fincanva#quali-codici-di-errore-può-restituire-unoperazione-di-fincanva).

> **Non ancora nell’app.** Due passaggi richiedono schermate che non sono ancora nell’app: creare una chiave API, che richiede le impostazioni delle chiavi API, e completare l’accesso di un client MCP, che richiede la schermata di consenso.

## Quali operazioni di Fincanva puoi invocare?

Ogni operazione ha la sua pagina nel [Riferimento](/it/sviluppatori/riferimento), raggruppata per famiglia.

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)