Skip to main content
Ditto provides a Model Context Protocol (MCP) server that allows Claude Desktop, Claude Code, and other AI assistants to search and reference API documentation directly during development. This integration helps you discover best practices, avoid common pitfalls, and get contextual help while coding.

​
What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI assistants to access external data sources and tools. When you connect an MCP server to your AI assistant, it can search and reference documentation in real-time to provide more accurate and contextual responses.

​
Accessing Ditto’s MCP server

Ditto’s API documentation is accessible via MCP at: 
https://docs.ditto.live/mcp
This endpoint provides the AI assistant with access to:
  • Complete API reference documentation
  • Code examples and usage patterns
  • Best practices and common anti-patterns
  • Configuration guides and troubleshooting tips

​
Setting up with Claude Desktop

To use Ditto’s MCP server with Claude Desktop:
  1. Open your Claude Desktop configuration file:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the Ditto MCP server to your configuration: 
{
  "mcpServers": {
    "ditto-docs": {
      "command": "npx",
      "args": [
        "-y",
        "@mintlify/mcp-server",
        "https://docs.ditto.live/mcp"
      ]
    }
  }
}
  1. Restart Claude Desktop for the changes to take effect.
  2. Verify the connection by asking Claude about Ditto-specific topics. You should see a small icon indicating that Claude is accessing the Ditto documentation.
Learn more about configuring MCP servers in Claude Desktop.

​
Setting up with Claude Code

To use Ditto’s MCP server with Claude Code:
  1. Add the Ditto MCP server using the command line:
claude mcp add --transport http Ditto https://docs.ditto.live/mcp
  1. Verify the server was added successfully:
claude mcp list
  1. Restart Claude Code for the changes to take effect.
  2. Verify the connection by asking Claude about Ditto-specific topics while coding. Claude Code will automatically reference the Ditto documentation when relevant.
Learn more about configuring MCP servers in Claude Code.

​
Using with ChatGPT

To use Ditto’s MCP server with ChatGPT, you’ll need to use a compatible MCP client that works with OpenAI’s API. Several community tools are available:
  1. Install an MCP client that supports OpenAI integration
  2. Configure the client to connect to https://docs.ditto.live/mcp
  3. Use the client to interact with ChatGPT while having access to Ditto documentation
MCP support for ChatGPT is still evolving. Check the Model Context Protocol documentation and OpenAI’s documentation for the latest integration options.

​
Example usage

Once configured, you can ask your AI assistant questions like:
  • “How do I set up authentication with Ditto?”
  • “What’s the best way to structure my Ditto queries?”
  • “Show me how to implement offline-first sync with Ditto”
  • “What are common mistakes when using Ditto’s mesh networking?”
The AI assistant will search the Ditto documentation and provide answers with direct references to the relevant documentation pages.

​
Benefits

Using Ditto’s MCP integration provides several advantages:
  • Faster development: Get instant answers without leaving your development environment
  • Contextual help: The AI assistant can reference your specific use case against Ditto’s documentation
  • Best practices: Discover recommended patterns and avoid common pitfalls
  • Up-to-date information: Always access the latest documentation without manual searching

​
Troubleshooting

If you’re having issues connecting to the MCP server:
  1. Verify your configuration file syntax is correct (valid JSON)
  2. Ensure you have Node.js installed (required for the npx command)
  3. Check that you have an active internet connection
  4. Restart your AI assistant application after making configuration changes
For additional help, refer to the Model Context Protocol documentation or contact Ditto support.
⌘I