MCP Server Aroundigital

Endpoint e connessione

Il server è protetto da OAuth 2.1: i client MCP compatibili (ChatGPT, Claude, Cursor) avviano da soli il flusso di autorizzazione e mostrano la pagina di consenso Aroundigital. Il tool di scrittura create_knowledge_draft richiede inoltre il ruolo amministratore e salva l'articolo come bozza in attesa di revisione, senza pubblicare nulla.

Nei client che accettano un file di configurazione (Claude Desktop, Cursor, Codex):

{
  "mcpServers": {
    "aroundigital": {
      "type": "http",
      "url": "https://aroundigital.com/mcp"
    }
  }
}

Nei client che chiedono solo un URL (ChatGPT connectors, Claude web) è sufficiente incollare https://aroundigital.com/mcp.

Specifica JSON unificata

Schema dei parametri, formato della risposta, esempi di request/response ed errori per tutti e tre i tool sono raccolti in un unico file, pensato per essere passato direttamente a un agente o importato in un client:

tools-spec.jsonhttps://aroundigital.com/mcp-docs/tools-spec.json

curl -s https://aroundigital.com/mcp-docs/tools-spec.json | jq .tools[].name

Il file contiene, per ogni tool: inputSchema e outputSchema in JSON Schema draft-07, when_to_use, example_request, example_response e il comportamento in caso di risultato vuoto. Le sezioni comuni descrivono l'envelope di risposta MCP, la config client e la tabella errori.

Chiamate dirette in HTTP

Playground

Prova i tre tool direttamente da qui: la chiamata parte da questo browser verso https://aroundigital.com/mcp e mostra request JSON-RPC ed envelope MCP di risposta.

Ogni richiesta è JSON-RPC 2.0 su POST. L'header Accept: application/json, text/event-stream è obbligatorio dallo spec: senza, il server risponde 406 Not Acceptable.

curl -X POST https://aroundigital.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

1. search_aroundigital_knowledge

Ricerca semantica sulla Knowledge Base pubblica (digital strategy, AI business adoption, marketing operations, local marketing, eCommerce omnichannel, KPI e budgeting). Restituisce estratti con titolo e URL della pagina di origine. Sola lettura, idempotente.

curl -X POST https://aroundigital.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_aroundigital_knowledge",
      "arguments": {
        "query": "come costruire una roadmap digitale a 90 giorni",
        "limit": 3
      }
    }
  }'

La risposta contiene un blocco testuale con gli estratti numerati, ciascuno con titolo e URL della pagina pubblica di origine, utilizzabile come citazione.

2. ask_ara

Risposta consulenziale di ARA, l'assistente AI di Aroundigital, ancorata alla stessa Knowledge Base e con fonti citate in coda. Da preferire a search_aroundigital_knowledge quando serve una sintesi ragionata invece di estratti grezzi.

curl -X POST https://aroundigital.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "ask_ara",
      "arguments": {
        "question": "Quali KPI di marketing ha senso misurare in una PMI B2B?"
      }
    }
  }'

3. book_confronto_strategico

Invia ad Aroundigital una richiesta di confronto strategico gratuito. Non è di sola lettura: genera un lead reale. Va usato solo dopo che l'utente ha esplicitamente confermato di volerlo e ha fornito dati di contatto reali. L'endpoint applica un rate limit di 3 richieste per ora e per indirizzo IP.

curl -X POST https://aroundigital.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "book_confronto_strategico",
      "arguments": {
        "nome": "Mario Rossi",
        "email": "mario.rossi@azienda.it",
        "azienda": "Azienda S.r.l.",
        "tema": "Roadmap digitale a 180 giorni",
        "note": "Team marketing di 3 persone, e-commerce B2C attivo da 2 anni."
      }
    }
  }'

Gestione degli errori

Dati esposti e privacy

I tool di lettura accedono esclusivamente ai contenuti già pubblicati su aroundigital.com: hub, articoli del Knowledge Hub, pagine servizi e toolkit. I moduli interni della Knowledge Base, i lead e i dati di conversazione non sono raggiungibili. Per i dati inviati tramite book_confronto_strategico vale l'Informativa Privacy dell'Assistente AI.

Serve supporto?

Per integrazioni su misura o tool dedicati al tuo team, prenota un confronto strategico.