Cooperate with AI Agents

Since 1.9.0, MarkInside provides a local MCP (Model Context Protocol) server. By connecting MarkInside to AI agents like Codex and Claude Code through MCP, you can ask the agent in natural language to directly edit content in MarkInside and help you generate images.

For example, if you want to generate a formula image for a normal distribution, you can simply tell the agent, “Help me create a normal distribution formula image in MarkInside.” The agent will create a new document in MarkInside and automatically enter the corresponding formula. You can then keep asking it to refine the image until you are satisfied.

Connect to the MCP Server Directly

By default, the server listens on port 9448.

You can check or change the port in MarkInside → Settings → MCP Server.

Replace <PORT> with your actual port number (use 9448 if unchanged).

Codex

First, add it to global scope using the Codex command:

codex mcp add --transport http markinside http://127.0.0.1:<PORT>/mcp

You can also add it directly in your configuration file:

• User-level: ~/.codex/config.toml
• Project-level: .codex/config.toml

[mcp_servers.markinside]
url = "http://127.0.0.1:<PORT>/mcp"

Claude Code

Register the MCP server:

claude mcp add --transport http markinside http://127.0.0.1:<PORT>/mcp

For project scope, run:

claude mcp add --transport http --scope project markinside http://127.0.0.1:<PORT>/mcp

You can also edit the project config file .mcp.json:

{
  "mcpServers": {
    "markinside": {
      "url": "http://127.0.0.1:<PORT>/mcp"
    }
  }
}