Saltar al contenido principal

​
Descripción general

Qué lograrás:
  • Agregar el servidor MCP de ABBYY Vantage a Claude Code
  • Verificar que la conexión funciona
  • Usar la herramienta SearchAbbyyVantageDocumentation para buscar en la documentación desde tu flujo de trabajo de IA
Tiempo estimado: ~5 minutos

​
¿Qué es el servidor MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA conectarse a herramientas y fuentes de datos externas. Al añadir un servidor MCP a Claude Code, das a la IA acceso directo a datos estructurados o funciones, sin tener que copiar y pegar contenido manualmente. El servidor MCP de ABBYY Vantage expone una única herramienta, SearchAbbyyVantageDocumentation, que realiza una búsqueda semántica en toda la documentación de Vantage. Cuando Claude Code tiene conectado este servidor, puede buscar parámetros de API, opciones de configuración de skill, pasos de solución de problemas y mucho más, automáticamente mientras trabajas.
El servidor MCP proporciona acceso de solo lectura a la documentación pública. No se conecta a tu tenant de Vantage, no procesa documentos ni requiere credenciales de Vantage.

​
Requisitos previos

  • Claude Code instalado y en ejecución
  • Acceso a la terminal (macOS, Linux o Windows con WSL)
No se requiere ningún tenant ni cuenta de ABBYY Vantage para usar el servidor MCP.
1

Agregar mediante CLI (recomendado)

Ejecute el siguiente comando en su terminal para registrar el servidor MCP en Claude Code:
Opciones de alcance:De forma predeterminada, esto agrega el servidor en el nivel de proyecto, lo que significa que solo está disponible en el directorio actual (guardado en .claude/settings.json). Para que esté disponible en todos sus proyectos, agregue la opción --scope user:
2

Alternativa: configuración manual

Si prefiere configurarlo manualmente, agregue el siguiente JSON a su archivo de configuración.
Cree o edite .claude/settings.json en la raíz de su proyecto:
Edite ~/.claude/settings.json en su directorio personal:
3

Verificar la conexión

Reinicie Claude Code y, a continuación, ejecute el siguiente comando de barra para comprobar que el servidor esté registrado:
Debería ver abbyy-vantage en la lista con el estado de conectado. Para confirmar que la herramienta funciona, haga a Claude una pregunta relacionada con Vantage:
“¿Qué parámetros requiere la API de procesamiento de Vantage para enviar un documento?”
Claude Code invocará SearchAbbyyVantageDocumentation y devolverá resultados de la documentación.
Si el servidor no aparece en /mcp, compruebe que la URL se haya introducido exactamente como https://docs.abbyy.com/mcp, sin barra diagonal final. Confirme también que su terminal tenga acceso a la red para acceder al servidor.

​
Herramientas disponibles

El servidor MCP de ABBYY Vantage ofrece una herramienta: SearchAbbyyVantageDocumentation Realiza una búsqueda semántica en la Documentación de ABBYY Vantage y devuelve el contenido más relevante. Claude Code invoca esta herramienta automáticamente cuando haces preguntas relacionadas con Vantage. Consultas de ejemplo:
  • “¿Cómo configuro una Skill de documento en Vantage?”
  • “¿Qué hace el parámetro minConfidence?”
  • “¿Cómo configuro una conexión a un LLM en Vantage?”
  • “¿Qué formatos de exportación admite Vantage?”
  • “¿Cómo me autentico con la API REST de Vantage?”

​
Casos de uso

  • Integraciones de API: Consulta parámetros de endpoint, métodos de autenticación y formatos de solicitud/respuesta sin salir de tu IDE
  • Configuración de Skills: Encuentra rápidamente opciones de configuración y prácticas recomendadas para Skills de documento, Habilidades de proceso y Advanced Designer
  • Solución de problemas: Busca mensajes de error y problemas conocidos para resolver incidencias más rápido mientras depuras integraciones
  • Exploración de capacidades: Descubre lo que admite Vantage — modelos de extracción, formatos compatibles y configuración del tenant — mientras planificas tu proyecto

​
Consejos para hacer consultas eficaces

  • Sea específico: Incluya el nombre de la función o el endpoint de la API en su pregunta, en lugar de hacer una consulta general
  • Use la terminología de Vantage: Términos como “Habilidad de proceso”, “Skill de documento”, “Skill Designer” y “tenant” devolverán resultados más precisos
  • Haga preguntas de seguimiento: Claude Code conserva el contexto, por lo que puede acotar los resultados con preguntas posteriores
  • Combínelo con su código: Pegue una respuesta de la API o un fragmento de configuración y pídale a Claude que lo explique usando la documentación de Vantage

​
Eliminar el servidor MCP

Para eliminar el servidor MCP de ABBYY Vantage de Claude Code, ejecute:
Si añadió el servidor a nivel de usuario, incluya la opción --scope user:

​
Resolución de problemas

El servidor no aparece en /mcp Verifica que el archivo de configuración se haya guardado correctamente y que el JSON sea válido (sin comas al final). Reinicia Claude Code por completo después de hacer los cambios. La herramienta no se invoca automáticamente Claude Code invoca herramientas MCP según su relevancia. Si la herramienta no se está usando, intenta formular tu pregunta de forma más explícita: “Busca en la documentación de ABBYY Vantage…” o menciona una función específica de Vantage por su nombre. La búsqueda devuelve resultados irrelevantes Reformula tu consulta usando términos de la interfaz o de la Documentación de Vantage. Evita usar términos genéricos como “flujo de trabajo” o “configuración” por sí solos; combínalos con “Vantage” o con el nombre de una función específica.

​
Resumen

Has completado correctamente lo siguiente:
  • ✅ Añadido el servidor MCP de ABBYY Vantage a Claude Code
  • ✅ Verificado la conexión usando /mcp
  • ✅ Aprendido a buscar en la Documentación desde tu flujo de trabajo de IA

​
Próximos pasos

Introducción a la API

Empiece a usar la API REST de procesamiento de Vantage

Procesamiento de documentos

Cree una Habilidad de proceso y automatice el procesamiento de documentos mediante SFTP

Configuración de conexiones LLM

Conecte Vantage a OpenAI o Microsoft Foundry

Extracción basada en prompts

Use prompts en lenguaje natural para extraer datos de documentos