Pular para o conteúdo principal

​
Visão geral

O que você vai fazer:
  • Adicionar o servidor ABBYY Vantage MCP ao Claude Code
  • Verificar se a conexão está funcionando
  • Usar a ferramenta SearchAbbyyVantageDocumentation para pesquisar a documentação diretamente no seu fluxo de trabalho de IA
Tempo estimado para conclusão: ~5 minutos

​
O que é o servidor MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem a ferramentas externas e fontes de dados. Ao adicionar um servidor MCP ao Claude Code, você dá ao assistente acesso direto a dados estruturados ou a funcionalidades — sem precisar copiar e colar conteúdo manualmente. O servidor MCP do ABBYY Vantage expõe uma única ferramenta, SearchAbbyyVantageDocumentation, que executa uma busca semântica em toda a documentação do Vantage. Quando o Claude Code está conectado a esse servidor, ele pode pesquisar parâmetros de API, opções de configuração de skill, etapas de solução de problemas e muito mais — automaticamente, enquanto você trabalha.
O servidor MCP fornece acesso somente leitura à documentação pública. Ele não se conecta ao seu tenant do Vantage, não processa documentos e não requer credenciais do Vantage.

​
Pré-requisitos

  • Claude Code instalado e em execução
  • Acesso ao terminal (macOS, Linux ou Windows com WSL)
Não é necessário ter um tenant nem uma conta do ABBYY Vantage para usar o servidor MCP.
1

Adicionar via CLI (Recomendado)

Execute o seguinte comando no seu terminal para registrar o servidor MCP no Claude Code:
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse
Opções de escopo:Por padrão, isso adiciona o servidor no nível de projeto, o que significa que ele fica disponível apenas no diretório atual (armazenado em .claude/settings.json). Para torná-lo disponível em todos os seus projetos, adicione a opção --scope user:
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse --scope user
EscopoArquivo de configuraçãoQuando usar
Projeto (padrão).claude/settings.jsonUm projeto específico
Usuário~/.claude/settings.jsonTodos os projetos nesta máquina
2

Alternativa: Configuração manual

Se preferir configurar manualmente, adicione o seguinte JSON ao seu arquivo de configurações.
Crie ou edite .claude/settings.json na raiz do seu projeto:
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
Edite ~/.claude/settings.json no seu diretório pessoal (home):
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

Verificar a conexão

Reinicie o Claude Code e, em seguida, execute o seguinte comando de barra para verificar se o servidor foi registrado:
/mcp
Você deve ver abbyy-vantage listado com status de conectado. Para confirmar que a ferramenta está funcionando, faça ao Claude uma pergunta relacionada ao Vantage:
“Quais parâmetros a Vantage Processing API exige para enviar um documento?”
O Claude Code irá invocar SearchAbbyyVantageDocumentation e retornar resultados da documentação.
Se o servidor não aparecer em /mcp, verifique se a URL foi inserida exatamente como https://docs.abbyy.com/mcp, sem barra no final. Também confirme se o seu terminal tem acesso de rede para alcançar o servidor.

​
Ferramentas disponíveis

O servidor ABBYY Vantage MCP expõe uma ferramenta: SearchAbbyyVantageDocumentation Realiza uma busca semântica na documentação do ABBYY Vantage e retorna o conteúdo mais relevante. O Claude Code invoca essa ferramenta automaticamente quando você faz perguntas relacionadas ao Vantage. Exemplos de consultas:
  • “Como configuro uma Document Skill no Vantage?”
  • “O que o Parameter minConfidence faz?”
  • “Como configuro uma conexão de LLM no Vantage?”
  • “Quais formatos de exportação o Vantage oferece suporte?”
  • “Como faço a autenticação na REST API do Vantage?”

​
Casos de uso

Integrações de API

Pesquise parâmetros de endpoint, métodos de autenticação e formatos de requisição/resposta sem sair do seu IDE

Configuração de Skill

Encontre rapidamente opções de configuração e boas práticas para Skills de Documento, Skills de Processo e Advanced Designer

Solução de Problemas

Pesquise mensagens de erro e problemas conhecidos para resolver incidentes mais rapidamente ao depurar integrações

Explorando capacidades

Descubra o que o Vantage suporta — modelos de extração, formatos compatíveis, configurações do tenant — enquanto você planeja seu projeto

​
Dicas para consultas eficazes

  • Seja específico: Inclua o nome do recurso ou o endpoint da API na sua pergunta em vez de perguntar de forma genérica
  • Use a terminologia do Vantage: Termos como “Skill de Processo”, “Skill de Documento”, “Skill Designer” e “tenant” retornarão resultados mais precisos
  • Faça perguntas de acompanhamento: Claude Code mantém o contexto, assim você pode refinar os resultados com perguntas adicionais
  • Combine com o seu código: Cole uma resposta de API ou um trecho de configuração e peça ao Claude para explicá-la usando a documentação do Vantage

​
Solução de problemas

Servidor não aparece em /mcp Verifique se o arquivo de configuração foi salvo corretamente e se o JSON é válido (sem vírgulas finais). Reinicie completamente o Claude Code após fazer alterações. Ferramenta não é acionada automaticamente O Claude Code aciona ferramentas MCP com base na relevância. Se a ferramenta não estiver sendo usada, tente formular sua pergunta de forma mais explícita: “Pesquise na documentação do ABBYY Vantage por…” ou mencione pelo nome um recurso específico do Vantage. Pesquisa retorna resultados irrelevantes Reformule sua consulta usando termos da interface ou da documentação do Vantage. Evite termos genéricos como “workflow” ou “configurações” sozinhos — combine-os com “Vantage” ou com o nome de um recurso específico.

​
Resumo

Você concluiu com sucesso:
  • ✅ Adicionou o servidor MCP da ABBYY Vantage ao Claude Code
  • ✅ Verificou a conexão usando /mcp
  • ✅ Aprendeu como acionar a pesquisa na documentação a partir do seu fluxo de trabalho de IA

​
Próximos passos

Introdução à API

Comece a usar a REST API de processamento do Vantage

Processando documentos

Crie uma Skill de Processo e automatize o processamento de documentos via SFTP

Configurando conexões LLM

Conecte o Vantage ao OpenAI ou à Microsoft Foundry

Extração baseada em prompt

Use prompts em linguagem natural para extrair dados de documentos