MCP connections

Copy an install command or configuration from Midmap to connect an agent app to your boards.

What is an MCP connection?

MCP (Model Context Protocol) is an open protocol for connecting AI apps with external tools and data sources. Learn more on the MCP website.

Midmap includes an MCP service that can connect to agents or AI apps with MCP support. Once connected, an agent in the app can read or update your boards as you ask.

You can enable or disable the service and change its port under Settings → MCP.

Add an app in Midmap

Midmap’s MCP service is enabled by default. Check its status under Settings → MCP.

If the service is disabled, turn it on and confirm that the status is Running.

In the Agent section, click the add button and choose the app you use. The following agent apps are currently confirmed to work with Midmap:

• Claude Code
• Codex
• GitHub Copilot
• OpenCode
• Pi
• Qoder
• CodeBuddy
• WorkBuddy
• TraeCode
• TraeWork

To connect another app that supports MCP, choose Other and enter its name.

Add the Midmap configuration to your app

After adding the app in Midmap, complete setup based on its type:

• CLI apps: Click Copy install command, then run it in a terminal.
• Desktop apps: Click Copy MCP configuration, then paste it into the app’s MCP settings.

Here is an example configuration. Replace the port and token with the values copied from Midmap:

{
  "mcpServers": {
    "midmap": {
      "type": "http",
      "url": "http://localhost:<PORT>/mcp?token=<TOKEN>"
    }
  }
}

Make sure the app you are configuring matches the agent name you added in Midmap. If the app needs its MCP configuration reloaded or the app restarted, follow its instructions.

What can Midmap MCP do?

• View the current board: Read the current board, selected node, and unread messages on the board. Unread messages returned with the current board are marked as read after the agent retrieves them.
• Find and manage boards: List boards to find the one you need, and create or delete boards.
• Work with nodes: Read the node hierarchy and content; add, edit, move, reorder, or delete nodes; and update titles, descriptions, to-dos, marks, images, and links.

When an agent updates a board through MCP, the current board view in Midmap updates in real time.

Node changes create operation records. Changed nodes are marked, and Midmap shows an operation notification. Review the changes in the notification, then keep or undo them.

Manage connections

Each app has its own configuration. Deleting an app entry in Midmap prevents that app from connecting with its current configuration. To reconnect, add the app again and replace its old configuration with the new one.

If you change the MCP port, or need to change it because it is already in use, copy a fresh configuration for each app and update the old configuration in the app.

Next steps

• Getting started: Connect an agent and create a board.
• Working with agents: Learn how to give an agent node context and review its changes.
• FAQ and troubleshooting: Find steps for common connection issues.

← Back to product docs