---
title: "Primi passi con l’Open API e il server MCP di Fincanva"
description: "Una prima chiamata a Fincanva: una richiesta REST a list_allocation_methods con una chiave API, o un client MCP collegato al server MCP di Fincanva con OAuth."
canonical_url: "https://fincanva.com/it/sviluppatori/primi-passi/primi-passi-con-l-open-api-e-il-server-mcp-di-fincanva"
last_updated: "2026-10-03"
md_url: "https://fincanva.com/it/sviluppatori/primi-passi/primi-passi-con-l-open-api-e-il-server-mcp-di-fincanva.md"
---

# Primi passi con l’Open API e il server MCP di Fincanva

Le operazioni di Fincanva si raggiungono in due modi: come strumenti in un client MCP, oppure come endpoint REST che il tuo codice chiama. Questa pagina ti porta a una prima chiamata con ciascuno.

## Come si fa una prima chiamata REST?

Invia `POST` a `https://app.fincanva.com/api/v1/research/list_allocation_methods` con il corpo JSON `{}`: l’operazione non ha parametri obbligatori, quindi un oggetto vuoto è una richiesta completa. Autenticati con una chiave API, come `Authorization: Bearer` seguito dalla chiave oppure nell’intestazione `x-api-key`.

La risposta è la [struttura del risultato](/it/sviluppatori/concetti/la-struttura-del-risultato): `status: true` e un oggetto `data` il cui `result` elenca ogni metodo di allocazione che Fincanva offre. Quali piani includono l’Open API lo trovi in [Piani, quote e limiti](/it/sviluppatori/primi-passi/piani-quote-e-limiti).

## Come si collega un client MCP?

Aggiungi `https://app.fincanva.com/mcp` a un client MCP che si collega a server remoti via Streamable HTTP. Il client accede con OAuth: il server gli indica dove, attraverso i documenti di discovery elencati in [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api). Ogni operazione compare poi come uno strumento con il nome del suo id.

## Da dove si prosegue?

- [Il server MCP di Fincanva](/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva) — il trasporto, gli strumenti e che cosa riceve un client quando si collega.
- [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) — ogni credenziale e che cosa può chiamare.
- [Piani, quote e limiti](/it/sviluppatori/primi-passi/piani-quote-e-limiti) — quali piani includono ciascuna superficie, e le quote mensili.
- [Il Riferimento](/it/sviluppatori/riferimento) — ogni operazione, una pagina ciascuna.

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)