Vai al contenuto principale

​
Panoramica

Cosa farai:
  • Aggiungere il server MCP di ABBYY Vantage a GitHub Copilot in VS Code
  • Verificare che la connessione funzioni correttamente
  • Utilizzare lo strumento SearchAbbyyVantageDocumentation per cercare nella documentazione direttamente da Copilot Chat
Tempo di completamento: ~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 GitHub Copilot, consenti all’AI di accedere direttamente 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 nell’intera documentazione di Vantage. Quando Copilot è connesso a questo server, può cercare automaticamente, mentre lavori, parametri API, opzioni di configurazione delle skill, procedure di risoluzione dei problemi e altro ancora.
Il server MCP fornisce accesso di sola lettura alla documentazione pubblica. Non si connette al tenant di Vantage, non elabora documenti e non richiede credenziali Vantage.

​
Prerequisiti

  • VS Code versione 1.99 o successiva (supporto MCP obbligatorio)
  • Estensione GitHub Copilot installata con accesso effettuato
Per utilizzare il server MCP non è necessario alcun tenant o account ABBYY Vantage.
1

Aggiunta tramite Command Palette (consigliata)

Usa la Command Palette di VS Code per registrare il server MCP:
  1. Apri la Command Palette con Cmd+Shift+P (macOS) o Ctrl+Shift+P (Windows/Linux)
  2. Digita “MCP: Add Server…” e selezionalo
  3. Seleziona HTTP come tipo di trasporto
  4. Inserisci l’URL: https://docs.abbyy.com/mcp
  5. Inserisci il nome: abbyy-vantage
  6. Scegli l’ambito: Workspace o User
AmbitoPosizione della configurazioneQuando utilizzarlo
Workspace.vscode/mcp.jsonUn progetto specifico
UserImpostazioni utente tramite Command PaletteTutti i progetti su questo computer
2

Alternativa: configurazione manuale

Se preferisci configurarlo manualmente, aggiungi la voce del server al file di configurazione appropriato.
Crea o modifica .vscode/mcp.json nella directory radice del progetto:
{
  "servers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
Apri la Command Palette (Cmd+Shift+P / Ctrl+Shift+P), digita “MCP: Open User Configuration” e aggiungi la seguente voce:
{
  "servers": {
    "abbyy-vantage": {
      "type": "http",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

Verifica della connessione

  1. Apri la Command Palette ed esegui “MCP: List Servers” — verifica che abbyy-vantage risulti connesso
  2. Apri Copilot Chat (fai clic sull’icona di Copilot nella barra laterale oppure premi Ctrl+Shift+I / Cmd+Shift+I)
  3. Passa alla modalità Agent usando il selettore di modalità nella parte superiore del pannello della chat
  4. Fai clic sull’icona degli strumenti nel campo di input della chat — verifica che SearchAbbyyVantageDocumentation compaia nell’elenco
  5. Prova con una domanda:
“Quali parametri richiede la Vantage Processing API per inviare un documento?”
Copilot richiamerà SearchAbbyyVantageDocumentation e restituirà risultati dalla documentazione.
L’URL deve essere inserito esattamente come https://docs.abbyy.com/mcp, senza barra finale. Verifica inoltre che VS Code abbia accesso alla rete per raggiungere il server.

​
Strumenti disponibili

Il server MCP di ABBYY Vantage espone uno strumento: SearchAbbyyVantageDocumentation Esegue una ricerca semantica nella documentazione di ABBYY Vantage e restituisce i contenuti più pertinenti. Copilot richiama automaticamente questo strumento in modalità Agent quando poni domande relative a Vantage. Esempi di query:
  • “Come si configura un Document Skill in Vantage?”
  • “A cosa serve il parametro minConfidence?”
  • “Come si configura una connessione LLM in Vantage?”
  • “Quali formati di esportazione supporta Vantage?”
  • “Come si esegue l’autenticazione con l’API REST di Vantage?”

​
Casi d’uso

Integrazioni API

Consulta i parametri degli endpoint, i metodi di autenticazione e i formati di richiesta e 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 risolverli più rapidamente durante il debug delle integrazioni

Esplorazione delle funzionalità

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

​
Suggerimenti per query efficaci

  • Sii specifico: Includi nella domanda il nome della funzionalità o dell’endpoint API, invece di porre una richiesta generica
  • Usa la terminologia di Vantage: Termini come “Process Skill”, “Document Skill”, “Skill Designer” e “tenant” restituiscono risultati più precisi
  • Fai domande di approfondimento: Copilot mantiene il contesto, quindi puoi restringere i risultati con prompt successivi
  • Combina il tutto con il tuo codice: Incolla una risposta API o uno snippet di configurazione e chiedi a Copilot di spiegarlo usando la documentazione di Vantage
  • Usa la modalità Agent: Gli strumenti MCP sono disponibili solo in modalità Agent — assicurati che il selettore della modalità sia impostato su “Agent” prima di fare la richiesta

​
Rimozione del server MCP

Puoi rimuovere il server con uno dei due metodi seguenti: Tramite la Command Palette:
  1. Apri la Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
  2. Esegui “MCP: List Servers”
  3. Seleziona abbyy-vantage
  4. Scegli Remove
Tramite il file di configurazione: Elimina la voce abbyy-vantage da .vscode/mcp.json (workspace) o dalla configurazione MCP utente.

​
Risoluzione dei problemi

Il server non compare in “MCP: List Servers” Verifica che il file di configurazione sia stato salvato correttamente e che il JSON sia valido (senza virgole finali). Se hai modificato il file manualmente, prova a ricaricare VS Code (Developer: Reload Window dalla Command Palette). Versione di VS Code troppo vecchia Il supporto per MCP richiede VS Code 1.99 o versione successiva. Controlla la versione in uso tramite Help → About e aggiorna se necessario. Lo strumento non viene richiamato automaticamente Copilot richiama gli strumenti MCP solo in modalità Agent. Assicurati di essere passato dalla modalità “Ask” o “Edit” a “Agent” usando il selettore della modalità nella parte superiore del pannello Copilot Chat. Se lo strumento continua a non essere usato, prova a formulare la richiesta in modo più esplicito: “Cerca nella documentazione di ABBYY Vantage…” oppure menziona per nome una funzionalità specifica di Vantage. La ricerca restituisce risultati irrilevanti Riformula la query usando termini dell’interfaccia o della documentazione di Vantage. Evita termini generici come “workflow” o “settings” presi da soli: abbinali a “Vantage” o al nome di una funzionalità specifica.
Hai completato con successo queste operazioni:
  • ✅ Hai aggiunto il server MCP di ABBYY Vantage a GitHub Copilot in VS Code
  • ✅ Hai verificato la connessione usando “MCP: List Servers”
  • ✅ Hai imparato come avviare la ricerca nella documentazione da Copilot Chat in modalità Agent

​
Passaggi successivi

Introduzione alle API

Inizia a utilizzare l’API REST di elaborazione di Vantage

Elaborazione dei documenti

Crea un Process Skill e automatizza l’elaborazione dei documenti tramite SFTP

Configurazione delle connessioni LLM

Collega Vantage a OpenAI o Microsoft Foundry

Estrazione basata su prompt

Usa prompt in linguaggio naturale per estrarre i dati dai documenti

Server MCP per Claude Code

Aggiungi lo stesso server MCP a Claude Code