Skip to content

Integrations / MCP

Put your agent to work on your data.

Connect a compatible AI agent to Annota AI through the Model Context Protocol (MCP). One connection covers Annota Studio and Annota Brain, so you can work with your datasets, annotations, documents, and knowledge bases from the same conversation.

Manage your data from your AI agent.

Setup

Connect in a few steps.

You need an Annota AI account and an AI client that supports remote MCP servers with Streamable HTTP and OAuth, such as Codex, Claude, or OpenCode.

  1. Open Integrations

    Sign in to Annota AI, select your organization, and open Integrations in the Annota Studio sidebar. Copy the MCP server URL shown there.

  2. Add Annota AI to your agent

    Add a remote MCP server with that URL: name it annota-ai in Codex and OpenCode, or add a custom connector named Annota AI in Claude. The Integrations page has a setup prompt and step-by-step instructions for each client.

  3. Sign in and authorize

    Complete the browser sign-in and authorization flow with your Annota AI account. The agent works with your existing organization permissions.

  4. Check the connection

    Ask your agent to list your organizations and datasets. Start with this read-only request before editing any data.

    Show me the datasets available in my Annota AI organizations.

Tools

What your agent can do.

Your agent works on the same data you see in the app.

WorkflowExample MCP tools
Explore your organizationslist_organizations · list_datasets · list_assets
Manage image annotationslist_labels · create_annotation · update_annotation
Review document OCRread_document_page · update_document_page · update_asset_review_status
Run automatic annotationpreview_auto_annotate_run · start_auto_annotate_run · get_auto_annotate_run
Ask your knowledge baseslist_knowledge_bases · search_knowledge_bases · read_knowledge_base_pages · send_chat_message
Create and retrieve exportscreate_export · get_export

Examples

Start with a real task.

Inspect an image dataset

"List the labels in my image dataset and show me which assets still need review."

Review extracted text

"Show me the OCR text for the first document in my document dataset. Suggest corrections for me to review before saving changes."

Ask Brain

"Search my knowledge base for the payment terms in our supplier contracts and cite the pages."

Retrieve an export

"List the available exports for this dataset and retrieve the latest completed one."

Access and credits

The same permissions. The same credits.

Access follows your account

The connection can access the organizations you belong to, within your existing permissions.

Usage follows your plan

Billable operations use the same credits as in the app, and chat answers use your weekly allowance first. Reading knowledge base documents is free.

You can disconnect

Revoke access anytime from Authorized applications in your account settings.

Need help connecting?

Use the client instructions inside Integrations. If the connection fails, check the server URL, OAuth support, and authorization, then try again.