Overview
What you’ll accomplish:- Add the ABBYY Vantage MCP server to Claude Code
- Verify the connection is working
- Use the
SearchAbbyyVantageDocumentationtool to search docs from within your AI workflow
What Is the MCP Server?
The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. By adding an MCP server to Claude Code, you give the AI direct access to structured data or capabilities — without copying and pasting content manually. The ABBYY Vantage MCP server exposes a single tool,SearchAbbyyVantageDocumentation, that performs a semantic search across the full Vantage documentation. When Claude Code has this server connected, it can look up API parameters, skill configuration options, troubleshooting steps, and more — automatically, as you work.
The MCP server provides read-only access to public documentation. It does not connect to your Vantage tenant, process documents, or require any Vantage credentials.
Prerequisites
- Claude Code installed and running
- Terminal access (macOS, Linux, or Windows with WSL)
No ABBYY Vantage tenant or account is required to use the MCP server.
Add via CLI (Recommended)
Run the following command in your terminal to register the MCP server with Claude Code:Scope options:By default, this adds the server at the project level, meaning it’s available only in the current directory (stored in
.claude/settings.json). To make it available across all your projects, add the --scope user flag:| Scope | Config file | When to use |
|---|---|---|
| Project (default) | .claude/settings.json | One specific project |
| User | ~/.claude/settings.json | All projects on this machine |
Alternative: Manual Configuration
If you prefer to configure manually, add the following JSON to your settings file.
Project-level (.claude/settings.json)
Project-level (.claude/settings.json)
Create or edit
.claude/settings.json in your project root:User-level (~/.claude/settings.json)
User-level (~/.claude/settings.json)
Edit
~/.claude/settings.json in your home directory:Verify the Connection
Restart Claude Code, then run the following slash command to check that the server is registered:You should see
abbyy-vantage listed with a connected status. To confirm the tool is working, ask Claude a Vantage-related question:“What parameters does the Vantage Processing API require to submit a document?”Claude Code will invoke
SearchAbbyyVantageDocumentation and return results from the documentation.Available Tools
The ABBYY Vantage MCP server exposes one tool:SearchAbbyyVantageDocumentation
Performs a semantic search across the ABBYY Vantage documentation and returns the most relevant content. Claude Code invokes this tool automatically when you ask questions related to Vantage.
Example queries:
- “How do I configure a Document Skill in Vantage?”
- “What does the
minConfidenceparameter do?” - “How do I set up an LLM connection in Vantage?”
- “What export formats does Vantage support?”
- “How do I authenticate with the Vantage REST API?”
Use Cases
API Integrations
Look up endpoint parameters, authentication methods, and request/response formats without leaving your IDE
Skill Configuration
Quickly find configuration options and best practices for Document Skills, Process Skills, and Advanced Designer
Troubleshooting
Search for error messages and known issues to resolve problems faster while debugging integrations
Exploring Capabilities
Discover what Vantage supports — extraction models, supported formats, tenant settings — as you plan your project
Tips for Effective Queries
- Be specific: Include the feature name or API endpoint in your question rather than asking generally
- Use Vantage terminology: Terms like “Process Skill”, “Document Skill”, “Skill Designer”, and “tenant” will return more precise results
- Ask follow-up questions: Claude Code retains context, so you can narrow down results with follow-up prompts
- Combine with your code: Paste an API response or config snippet and ask Claude to explain it using the Vantage docs
Troubleshooting
Server doesn’t appear in/mcp
Verify the configuration file was saved correctly and that the JSON is valid (no trailing commas). Restart Claude Code fully after making changes.
Tool is not invoked automatically
Claude Code invokes MCP tools based on relevance. If the tool isn’t being used, try asking your question more explicitly: “Search the ABBYY Vantage docs for…” or mention a specific Vantage feature by name.
Search returns irrelevant results
Rephrase your query using terms from the Vantage interface or documentation. Avoid generic terms like “workflow” or “settings” on their own — pair them with “Vantage” or a specific feature name.
Summary
You’ve successfully:- ✅ Added the ABBYY Vantage MCP server to Claude Code
- ✅ Verified the connection using
/mcp - ✅ Learned how to trigger documentation search from within your AI workflow
Next Steps
API Introduction
Get started with the Vantage Processing REST API
Processing Documents
Create a Process Skill and automate document processing via SFTP
Configuring LLM Connections
Connect Vantage to OpenAI or Microsoft Foundry
Prompt-Based Extraction
Use natural language prompts to extract data from documents
