AnythingMCP
Back to Guides

Come convertire qualsiasi API REST in un server MCP

Guida completa per convertire API REST in server MCP per Claude, ChatGPT e Copilot. Trasforma qualsiasi endpoint REST in uno strumento pronto per l'IA con AnythingMCP.

Perché convertire le API REST in MCP?

Il Model Context Protocol (MCP) è lo standard che consente agli assistenti IA come Claude, ChatGPT e Copilot di interagire con strumenti esterni. Convertendo la tua API REST in un server MCP, permetti agli agenti IA di chiamare i tuoi endpoint usando il linguaggio naturale, senza codice personalizzato.

Cosa serve

  • Un'API REST (qualsiasi API con endpoint HTTP)
  • Docker installato sulla tua macchina
  • Un client IA compatibile con MCP (Claude Desktop, ChatGPT, Copilot, Cursor, ecc.)

Passo dopo passo: Converti la tua API REST

Passo 1: Distribuire AnythingMCP

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Questo avvia il backend (porta 4000), la dashboard (porta 3000) e PostgreSQL.

Passo 2: Creare un connettore REST

Apri la dashboard su http://localhost:3000 e crea un nuovo connettore REST. Puoi importare la tua API da:

  • Specifica OpenAPI/Swagger — Incolla l'URL o carica il file JSON/YAML
  • Collezione Postman — Importa direttamente un'esportazione Postman
  • Comandi cURL — Incolla i comandi cURL e AnythingMCP li analizza trasformandoli in endpoint

Passo 3: Configurare l'autenticazione

Imposta il metodo di autenticazione della tua API nelle impostazioni del connettore:

  • Bearer Token
  • Chiave API (intestazione o query)
  • Basic Auth
  • OAuth 2.0

Le variabili d'ambiente possono essere usate per i segreti in modo che restino fuori dalla configurazione.

Passo 4: Verificare gli strumenti MCP generati automaticamente

AnythingMCP converte automaticamente ogni endpoint REST in uno strumento MCP. Verifica gli strumenti nella dashboard, personalizza nomi e descrizioni, e nascondi gli endpoint che non vuoi esporre.

Passo 5: Collegare il tuo assistente IA

Aggiungi il server MCP alla configurazione del tuo client IA:

{
  "mcpServers": {
    "my-api": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Ora il tuo assistente IA può chiamare gli endpoint della tua API REST attraverso il linguaggio naturale.

Funziona con tutti i principali strumenti IA

  • Claude Desktop — Supporto MCP completo
  • ChatGPT — Tramite plugin MCP
  • Microsoft Copilot — Integrazione MCP
  • Cursor — Supporto MCP integrato
  • Windsurf — Supporto MCP nativo

Buone pratiche

  1. Inizia in sola lettura — Esponi prima gli endpoint GET, poi aggiungi le operazioni di scrittura
  2. Usa nomi significativi — Rinomina gli strumenti nella dashboard per maggiore chiarezza
  3. Aggiungi descrizioni — Aiuta gli agenti IA a capire cosa fa ogni strumento
  4. Imposta limiti di frequenza — Proteggi la tua API da chiamate eccessive

Prossimi passi