AnythingMCP
Back to Guides

Iniziare con AnythingMCP

Installa e configura AnythingMCP in pochi minuti. Clona il repository, esegui lo script di configurazione interattivo e inizia a collegare le tue API agli agenti AI.

Cos'è AnythingMCP?

AnythingMCP è un gateway open-source che trasforma le tue API REST, SOAP, GraphQL e i tuoi database in server MCP (Model Context Protocol). Una volta collegati, puoi interagire con i tuoi sistemi attraverso agenti AI come Claude, ChatGPT, Copilot o qualsiasi client compatibile con MCP.

Prerequisiti

  • Docker e Docker Compose — Installa Docker
  • Git — per clonare il repository
  • Un terminale — bash su macOS o Linux

Per lo sviluppo locale senza Docker (opzionale):

  • Node.js 22+
  • npm

Avvio rapido

1. Clonare il repository

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp

2. Eseguire lo script di configurazione

bash setup.sh

La procedura guidata interattiva ti accompagna attraverso l'intera configurazione:

Passaggio 1 — Modalità di distribuzione Scegli tra Docker (consigliato per la produzione) o sviluppo locale.

Passaggio 2 — Dominio e porte Inserisci il tuo hostname. Per l'uso locale, mantieni il valore predefinito localhost. Per la produzione, inserisci il tuo dominio (es. mcp.example.com) e lo script configurerà Caddy come reverse proxy con SSL automatico Let's Encrypt.

Passaggio 3 — Segreti Tutte le credenziali di sicurezza vengono generate automaticamente:

  • Segreto JWT per l'autenticazione
  • Chiave di crittografia per i dati sensibili
  • Password del database
  • Segreto NextAuth

Passaggio 4 — Autenticazione MCP Scegli come gli agenti AI si autenticano con il tuo endpoint MCP:

  • OAuth 2.0 (consigliato)
  • Chiave API / Token Bearer (legacy)
  • Entrambi (OAuth + fallback legacy)
  • Nessuno (solo sviluppo)

Passaggio 5 — Email (opzionale) Configura SMTP per la verifica degli utenti, gli inviti e la reimpostazione della password.

Passaggio 6 — Redis (opzionale) Abilita Redis per la limitazione della frequenza e il caching delle risposte.

Lo script genera il file .env, configura Docker Compose e avvia tutti i servizi automaticamente.

3. Aprire la dashboard

Una volta completata la configurazione, apri la dashboard:

  • Locale: http://localhost:3000
  • Con dominio: https://mcp.example.com

Registra il tuo account amministratore — il primo utente a registrarsi diventa l'amministratore.

Collegare la tua prima API

  1. Accedi alla dashboard
  2. Clicca su Create Connector
  3. Scegli il tipo di connettore (REST, SOAP, GraphQL o Database)
  4. Configura la connessione (importa le specifiche OpenAPI, WSDL o inserisci le credenziali del database)
  5. Salva e attiva

Il tuo endpoint MCP è pronto su:

http://localhost:4000/mcp

Collegare un agente AI

Aggiungi il tuo server MCP a qualsiasi client AI compatibile. Esempio per Claude Desktop (oppure aggiungi l'URL del server direttamente in Claude.ai → Connectors):

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

Architettura

AnythingMCP funziona come un singolo container con due servizi:

| Servizio | Porta | Descrizione | |---------|------|-------------| | Backend (NestJS) | 4000 | API, endpoint MCP, server OAuth | | Frontend (Next.js) | 3000 | Dashboard web |

Servizi aggiuntivi:

  • PostgreSQL 17 — memorizza connettori, utenti e configurazione
  • Caddy (opzionale) — reverse proxy con SSL automatico
  • Redis (opzionale) — limitazione della frequenza e caching delle risposte

Comandi comuni

# Visualizzare i log
docker compose logs -f

# Riavviare i servizi
docker compose restart

# Fermare i servizi
docker compose down

# Aggiornare all'ultima versione
git pull && docker compose up -d --build

Passaggi successivi