Saltar al contenido principal

Descripción general

Lo que conseguirás:
  • Agregar el servidor MCP de ABBYY Vantage a Claude Code
  • Verificar que la conexión funcione
  • Usar la herramienta SearchAbbyyVantageDocumentation para buscar 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 externas y orígenes de datos. Al agregar un servidor MCP a Claude Code, se le da a la IA acceso directo a datos estructurados o a funcionalidades, sin copiar y pegar contenido manualmente. El servidor MCP de ABBYY Vantage expone una sola herramienta, SearchAbbyyVantageDocumentation, que realiza una búsqueda semántica en toda la documentación de Vantage. Cuando Claude Code tiene este servidor conectado, puede consultar parámetros de API, opciones de configuración de skills, procedimientos de resolución de problemas y más, automáticamente, mientras se trabaja.
El servidor MCP proporciona acceso de solo lectura a la documentación pública. No se conecta a su entorno 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 un tenant ni una cuenta de ABBYY Vantage para usar el servidor MCP.

1

Agregar vía CLI (recomendado)

Ejecute el siguiente comando en su terminal para registrar el servidor MCP en Claude Code:
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse
Opciones de ámbito (scope):De forma predeterminada, esto agrega el servidor a nivel de proyecto, lo que significa que solo está disponible en el directorio actual (se guarda en .claude/settings.json). Para que esté disponible en todos sus proyectos, agregue la opción --scope user:
claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport sse --scope user
ÁmbitoArchivo de configuraciónCuándo usarlo
Proyecto (predeterminado).claude/settings.jsonUn proyecto específico
Usuario~/.claude/settings.jsonTodos los proyectos en esta máquina
2

Alternativa: configuración manual

Si prefiere configurar todo manualmente, agregue el siguiente JSON a su archivo de configuración.
Cree o edite .claude/settings.json en la raíz de su proyecto:
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
Edite ~/.claude/settings.json en su directorio de inicio:
{
  "mcpServers": {
    "abbyy-vantage": {
      "type": "sse",
      "url": "https://docs.abbyy.com/mcp"
    }
  }
}
3

Verificar la conexión

Reinicie Claude Code y luego ejecute el siguiente comando slash para comprobar que el servidor esté registrado:
/mcp
Debería ver abbyy-vantage en la lista con el estado conectado. Para confirmar que la herramienta funciona, pídale a Claude una pregunta relacionada con Vantage:
“What parameters does the Vantage Processing API require to submit a document?”
Claude Code invocará SearchAbbyyVantageDocumentation y devolverá resultados de la documentación.
Si el servidor no aparece en /mcp, verifique que la URL esté introducida exactamente como https://docs.abbyy.com/mcp, sin una barra diagonal final. Confirme también que su terminal tenga acceso de red para llegar al servidor.

Herramientas disponibles

El servidor MCP de ABBYY Vantage pone a disposición una única herramienta: SearchAbbyyVantageDocumentation Realiza una búsqueda semántica en toda 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. Ejemplos de consultas:
  • “¿Cómo configuro una Skill de documento en Vantage?”
  • “¿Qué hace el parámetro minConfidence?”
  • “¿Cómo configuro una conexión con un LLM en Vantage?”
  • “¿Qué formatos de exportación admite Vantage?”
  • “¿Cómo me autentico en la API REST de Vantage?”

Casos de uso

Integraciones con la API

Consulte parámetros de endpoints, métodos de autenticación y formatos de solicitud y respuesta sin salir de su IDE

Configuración de skills

Encuentre rápidamente opciones de configuración y prácticas recomendadas para Skills de documento, Habilidades de proceso y Advanced Designer

Solución de problemas

Busque mensajes de error e incidencias conocidas para resolver problemas más rápido mientras depura las integraciones

Exploración de capacidades

Descubra qué ofrece Vantage — modelos de extracción, formatos compatibles, configuración del tenant — mientras planifica su proyecto

Consejos para consultas efectivas

  • Sé específico: Incluye el nombre de la funcionalidad o el endpoint de la API en tu pregunta, en lugar de formularla de manera general
  • Usa la terminología de Vantage: Términos como “Habilidad de proceso”, “Skill de documento”, “Skill Designer” y “tenant” ofrecerán resultados más precisos
  • Haz preguntas de seguimiento: Claude Code conserva el contexto, por lo que puedes acotar los resultados con preguntas de seguimiento
  • Combina las consultas con tu código: Pega una respuesta de la API o un fragmento de configuración y pídele a Claude que lo explique utilizando la documentación de Vantage

Solució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 completamente Claude Code después de hacer cambios. La herramienta no se invoca automáticamente Claude Code invoca herramientas MCP en función de su relevancia. Si la herramienta no se está utilizando, intenta formular tu pregunta de manera más explícita: “Search the ABBYY Vantage docs for…” o menciona por su nombre una funcionalidad específica de Vantage. La búsqueda devuelve resultados irrelevantes Reformula tu consulta usando términos de la interfaz o la documentación de Vantage. Evita términos genéricos como “workflow” o “settings” por sí solos; combínalos con “Vantage” o con el nombre de una funcionalidad específica.

Resumen

Has completado correctamente lo siguiente:
  • ✅ Has añadido el servidor MCP de ABBYY Vantage a Claude Code
  • ✅ Has verificado la conexión usando /mcp
  • ✅ Has aprendido a activar la búsqueda de documentación dentro de tu flujo de trabajo de IA

Próximos pasos