Vai al contenuto principale

​
Panoramica

Cosa farai:
  • Aggiungere il server MCP ABBYY Vantage a Claude Code
  • Verificare che la connessione funzioni
  • Usare lo strumento SearchAbbyyVantageDocumentation per cercare nella documentazione all’interno del tuo flusso di lavoro di IA
Tempo stimato: ~5 minuti

​
Che cos’è il server MCP?

Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti AI di connettersi a strumenti esterni e origini dati. Aggiungendo un server MCP a Claude Code, offri all’AI accesso diretto a dati strutturati o funzionalità — senza dover copiare e incollare manualmente i contenuti. Il server MCP di ABBYY Vantage espone un unico strumento, SearchAbbyyVantageDocumentation, che esegue una ricerca semantica sull’intera documentazione di Vantage. Quando questo server è connesso a Claude Code, può cercare parametri API, opzioni di configurazione delle skill, indicazioni per la risoluzione dei problemi e altro ancora — automaticamente, mentre lavori.
Il server MCP fornisce accesso di sola lettura alla documentazione pubblica. Non si connette al tuo tenant Vantage, non elabora documenti e non richiede alcuna credenziale Vantage.

​
Prerequisiti

  • Claude Code installato e in esecuzione
  • Accesso al terminale (macOS, Linux o Windows con WSL)
Non è necessario alcun tenant o account ABBYY Vantage per utilizzare il server MCP.
1

Aggiunta tramite CLI (consigliata)

Esegui il seguente comando nel terminale per registrare il server MCP con Claude Code:
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse
Opzioni di ambito (scope):Per impostazione predefinita, questo aggiunge il server a livello di progetto, il che significa che è disponibile solo nella directory corrente (memorizzato in .claude/settings.json). Per renderlo disponibile in tutti i tuoi progetti, aggiungi il parametro --scope user:
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse --scope user
AmbitoFile di configurazioneQuando usarlo
Project (default).claude/settings.jsonUn progetto specifico
User~/.claude/settings.jsonTutti i progetti su questa macchina
2

Alternativa: configurazione manuale

Se preferisci configurare manualmente, aggiungi il seguente JSON al file delle impostazioni.
Crea o modifica .claude/settings.json nella root del progetto:
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
Modifica ~/.claude/settings.json nella tua home directory:
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

Verifica della connessione

Riavvia Claude Code, quindi esegui il seguente comando con slash per verificare che il server sia registrato:
/mcp
Dovresti vedere abbyy-vantage elencato con uno stato connesso. Per confermare che lo strumento funziona, poni a Claude una domanda relativa a Vantage:
“Quali parametri richiede l’API Vantage Processing per inviare un documento?”
Claude Code invocherà SearchAbbyyVantageDocumentation e restituirà i risultati dalla documentazione.
Se il server non compare in /mcp, controlla che l’URL sia inserito esattamente come https://docs.abbyy.com/mcp senza slash finale. Verifica inoltre che il tuo terminale abbia accesso di rete per raggiungere il server.

​
Strumenti disponibili

Il server MCP di ABBYY Vantage espone uno strumento: SearchAbbyyVantageDocumentation Esegue una ricerca semantica sulla documentazione di ABBYY Vantage e restituisce il contenuto più rilevante. Claude Code richiama automaticamente questo strumento quando vengono poste domande relative a Vantage. Esempi di query:
  • “Come configuro una Document Skill in Vantage?”
  • “Che cosa fa il parametro minConfidence?”
  • “Come configuro una connessione LLM in Vantage?”
  • “Quali formati di esportazione supporta Vantage?”
  • “Come effettuo l’autenticazione con la API REST di Vantage?”

​
Casi d’uso

Integrazioni API

Consulta i parametri degli endpoint, i metodi di autenticazione e i formati di richiesta/risposta senza uscire dal tuo IDE

Configurazione delle Skill

Trova rapidamente le opzioni di configurazione e le best practice per Document Skills, Process Skills e Advanced Designer

Risoluzione dei problemi

Cerca messaggi di errore e problemi noti per risolvere più rapidamente i problemi durante il debug delle integrazioni

Esplorare le funzionalità

Scopri cosa offre Vantage — modelli di estrazione, formati supportati, impostazioni del tenant — mentre pianifichi il tuo progetto

​
Suggerimenti per query efficaci

  • Sii specifico: Includi il nome della funzionalità o l’endpoint API nella domanda invece di chiedere in modo generico
  • Usa la terminologia di Vantage: Termini come “Process Skill”, “Document Skill”, “Skill Designer” e “tenant” restituiscono risultati più precisi
  • Fai domande di approfondimento: Claude Code mantiene il contesto, quindi puoi restringere i risultati con prompt successivi
  • Combina con il tuo codice: Incolla una risposta API o uno snippet di configurazione e chiedi a Claude di spiegarlo utilizzando la documentazione di Vantage

​
Risoluzione dei problemi

Il server non compare in /mcp Verifica che il file di configurazione sia stato salvato correttamente e che il JSON sia valido (nessuna virgola finale). Riavvia completamente Claude Code dopo aver effettuato le modifiche. Lo strumento non viene avviato automaticamente Claude Code avvia gli strumenti MCP in base alla pertinenza. Se lo strumento non viene utilizzato, prova a formulare la domanda in modo più esplicito: “Cerca nella documentazione di ABBYY Vantage…” oppure menziona una specifica funzionalità di Vantage per nome. La ricerca restituisce risultati non pertinenti Riformula la query di ricerca usando i termini dell’interfaccia o della documentazione di Vantage. Evita termini generici come “workflow” o “impostazioni” da soli — abbinali a “Vantage” o al nome di una funzionalità specifica.
Hai completato con successo:
  • ✅ Aggiunto il server MCP di ABBYY Vantage a Claude Code
  • ✅ Verificato la connessione utilizzando /mcp
  • ✅ Imparato come attivare la ricerca nella documentazione direttamente dal tuo flusso di lavoro di IA

​
Prossimi passaggi

Introduzione all'API

Inizia a usare l’API REST di Vantage Processing

Elaborazione dei documenti

Crea una Process skill e automatizza l’elaborazione dei documenti tramite SFTP

Configurazione delle connessioni LLM

Collega Vantage a OpenAI o Microsoft Foundry

Estrazione basata sui prompt

Usa prompt in linguaggio naturale per estrarre dati dai documenti