Integrazione MCP

Il server MCP espone il tuo grafo, i punteggi e le raccomandazioni come tool che i tuoi agenti interrogano direttamente — senza scraping, senza codice ponte.

Configurazione

Il server parla Streamable HTTP su https://mcp.graphorank.com/mcp ed è disponibile dai piani Pro in su. Autenticati con una API key — le chiavi iniziano con gr_, richiedono lo scope read , e vengono create nell’app in API & MCP. Invia la chiave come Authorization: Bearer (oppure X-Api-Key).

In Claude Code, inserisci questo nel file di progetto .mcp.json:

JSON · .mcp.json

{
  "mcpServers": {
    "graphorank": {
      "type": "http",
      "url": "https://mcp.graphorank.com/mcp",
      "headers": { "Authorization": "Bearer gr_..." }
    }
  }
}

In Claude Desktop, aggiungi il server a claude_desktop_config.json tramite il bridge mcp-remote :

JSON · claude_desktop_config.json

{
  "mcpServers": {
    "graphorank": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.graphorank.com/mcp",
        "--header", "Authorization: Bearer gr_..."
      ]
    }
  }
}

Client supportati

Qualsiasi client che parla il Model Context Protocol: Claude Desktop, Claude Code, Cursor, e agenti personalizzati costruiti sull’MCP SDK.

Tool disponibili

ToolRestituisce

analyze_sitePanoramica dell’ultima scansione completata: GraphRank, punteggi per area e raccomandazioni principali.

get_site_graphNodi, archi, ruoli e PageRank dell’ultima scansione (nodi principali; segnala il troncamento sui grafi di grandi dimensioni).

get_geo_scoreGraphRank e punteggi per area con i controlli di prontezza GEO: llms.txt, sitemap, accessibilità ai crawler AI, answerability.

find_orphansPagine senza link interni in entrata nell’ultima scansione.

suggest_internal_linksPagine semanticamente simili non ancora collegate a una pagina: candidate per nuovi link interni.

compare_scansDelta tra due scansioni: GraphRank e punteggi per area, pagine aggiunte/rimosse, pagine orfane.

Tutti i tool sono di sola lettura: non avviano mai una scansione né toccano i tuoi dati. Il server pubblica anche le resource site://{domain}/graph e site://{domain}/report, più un audit_geo prompt che il tuo client può richiamare direttamente.

Disponibilità per piano

L’accesso MCP segue il tuo piano — le chiavi ereditano il piano del workspace che le ha create.

PianoAccesso MCP

FreeNon incluso.

StarterNon incluso.

ProLettura — tutti i tool e le resource sopra elencati.

AgencyLettura — tutti i tool e le resource sopra elencati.

EnterpriseLettura + scrittura — aggiunge tool di azione come l’avvio di scansioni.