> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add the Vantage MCP server to Claude Code

> Add the ABBYY Vantage MCP server to Claude Code to search Vantage documentation directly from your AI assistant while building integrations and skills.

## Overview

**What you'll accomplish:**

* Add the ABBYY Vantage MCP server to Claude Code
* Verify the connection is working
* Use the `SearchAbbyyVantageDocumentation` tool to search docs from within your AI workflow

**Time to complete:** \~5 minutes

***

## 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.

<Note>
  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.
</Note>

***

## Prerequisites

* [Claude Code](https://claude.ai/code) installed and running
* Terminal access (macOS, Linux, or Windows with WSL)

<Note>
  No ABBYY Vantage tenant or account is required to use the MCP server.
</Note>

***

<Steps>
  <Step title="Add via CLI (Recommended)">
    Run the following command in your terminal to register the MCP server with Claude Code:

    ```bash theme={null}
    claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport http
    ```

    **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:

    ```bash theme={null}
    claude mcp add abbyy-vantage https://docs.abbyy.com/mcp --transport http --scope user
    ```

    | Scope             | Config file               | When to use                  |
    | ----------------- | ------------------------- | ---------------------------- |
    | Project (default) | `.claude/settings.json`   | One specific project         |
    | User              | `~/.claude/settings.json` | All projects on this machine |
  </Step>

  <Step title="Alternative: Manual Configuration">
    If you prefer to configure manually, add the following JSON to your settings file.

    <AccordionGroup>
      <Accordion title="Project-level (.claude/settings.json)">
        Create or edit `.claude/settings.json` in your project root:

        ```json theme={null}
        {
          "mcpServers": {
            "abbyy-vantage": {
              "type": "http",
              "url": "https://docs.abbyy.com/mcp"
            }
          }
        }
        ```
      </Accordion>

      <Accordion title="User-level (~/.claude/settings.json)">
        Edit `~/.claude/settings.json` in your home directory:

        ```json theme={null}
        {
          "mcpServers": {
            "abbyy-vantage": {
              "type": "http",
              "url": "https://docs.abbyy.com/mcp"
            }
          }
        }
        ```
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Verify the Connection">
    Restart Claude Code, and then run the following slash command to check that the server is registered:

    ```
    /mcp
    ```

    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.

    <Warning>
      If the server doesn't appear in `/mcp`, check that the URL is entered exactly as `https://docs.abbyy.com/mcp` with no trailing slash. Also confirm that your terminal has network access to reach the server.
    </Warning>
  </Step>
</Steps>

***

## 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 `minConfidence` parameter 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

***

## Removing the MCP Server

To remove the ABBYY Vantage MCP server from Claude Code, run:

```bash theme={null}
claude mcp remove abbyy-vantage
```

If you added the server at the user level, include the `--scope user` flag:

```bash theme={null}
claude mcp remove abbyy-vantage --scope user
```

***

## 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

<CardGroup cols={2}>
  <Card title="API Introduction" icon="plug" href="/vantage/developer/api-introduction">
    Get started with the Vantage Processing REST API
  </Card>

  <Card title="Processing Documents" icon="file-lines" href="/vantage/documentation/skills/process-skill">
    Create a Process Skill and automate document processing via SFTP
  </Card>

  <Card title="Configuring LLM Connections" icon="brain" href="/vantage/documentation/skills/connections">
    Connect Vantage to OpenAI or Microsoft Foundry
  </Card>

  <Card title="Prompt-Based Extraction" icon="wand-magic-sparkles" href="/vantage/documentation/skills/prompt-extraction">
    Use natural language prompts to extract data from documents
  </Card>
</CardGroup>