Local MCP bridge

# Connect your AI client to Ink

Ink exposes the document you are editing through a local, authenticated MCP server. Start it manually, copy the connection details from Ink, then use the example for your client below.

Localhost only · off by default

Before you connect

Start the server and copy two values.

  1. 1
    Start Ink’s MCP server

    In LitSquare Ink MD, choose MCP → Start MCP Server.

  2. 2
    Copy the URL and token

    The connection window appears after every successful start. Keep the token private.

  3. 3
    Add the server to your client

    Replace YOUR_INK_TOKEN below, then restart or reload the client’s MCP servers.

Server name
litsquare-ink
Transport
Streamable HTTP
Default URL
http://127.0.0.1:51234/mcp
Authentication
Authorization: Bearer YOUR_INK_TOKEN

Client examples

Choose your local MCP client.

These examples all connect to the same Ink server. You can rotate or revoke its credential at any time in Ink’s MCP Settings.

Direct Streamable HTTP

Codex

~/.codex/config.toml

Add this table to your user configuration, then restart Codex or reload its MCP servers. 

[mcp_servers.litsquare_ink]
url = "http://127.0.0.1:51234/mcp"
http_headers = { Authorization = "Bearer YOUR_INK_TOKEN" }
Codex MCP documentation

Signed stdio adapter

Claude Desktop

claude_desktop_config.json

Merge this entry into the desktop configuration, fully quit the client, then reopen it. The adapter is embedded in the App Store installation and forwards only to Ink’s loopback endpoint. 

{
  "mcpServers": {
    "litsquare-ink": {
      "command": "/Applications/LitSquare Ink MD.app/Contents/Helpers/ink-mcp-adapter",
      "args": [
        "--endpoint",
        "http://127.0.0.1:51234/mcp"
      ],
      "env": {
        "INK_MCP_TOKEN": "YOUR_INK_TOKEN"
      }
    }
  }
}

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

Desktop MCP configuration guide

Direct Streamable HTTP

Cursor

~/.cursor/mcp.json

Add this server to the global MCP configuration, or use .cursor/mcp.json inside one project. 

{
  "mcpServers": {
    "litsquare-ink": {
      "type": "http",
      "url": "http://127.0.0.1:51234/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_INK_TOKEN"
      }
    }
  }
}
Cursor MCP documentation

Generic connection

Other MCP clients

Streamable HTTP

Any local client that supports Streamable HTTP and custom request headers can use the values below. 

{
  "name": "litsquare-ink",
  "transport": "streamable-http",
  "url": "http://127.0.0.1:51234/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_INK_TOKEN"
  }
}
About MCP

First connection

Ink keeps document access visible.

Approve the connection

Ink asks before a new local client can read or navigate open documents.

Review the first write

Before editing a document, Ink presents a native diff with Apply Once, Trust, and Deny choices.

Stop when finished

Choose MCP → Stop MCP Server. Stopping invalidates active sessions and temporary trust.