In breve
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, Claude.ai, ChatGPT, Copilot, Cursor, ecc.)
Passo dopo passo: Converti la tua API REST
Passo 1: Distribuire AnythingMCP
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
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 / Claude.ai — Supporto MCP completo
- ChatGPT — Tramite plugin MCP
- Microsoft Copilot — Integrazione MCP
- Cursor — Supporto MCP integrato
- Windsurf — Supporto MCP nativo
Buone pratiche
- Inizia in sola lettura — Esponi prima gli endpoint GET, poi aggiungi le operazioni di scrittura
- Usa nomi significativi — Rinomina gli strumenti nella dashboard per maggiore chiarezza
- Aggiungi descrizioni — Aiuta gli agenti IA a capire cosa fa ogni strumento
- Imposta limiti di frequenza — Proteggi la tua API da chiamate eccessive
Prossimi passi
- Convertire SOAP in MCP — Per i servizi SOAP legacy
- Convertire GraphQL in MCP — Per le API GraphQL
- Collegare il tuo database a MCP — Per l'accesso diretto al database
Questa guida ti è stata utile?
