mnapis

MCP 通道

MCP 客户端接入点：claude mcp add --transport http marginnote http://127.0.0.1:{port}/bridge/v1/mcp --header "Authorization: Bearer $TOKEN"。工具仅 mn_guide（规程）与 mn_call（{method,path,body} 转发）。GET /mcp 未实现（501），以 POST 通道为准。

POST
/mcp

MCP 客户端接入点：claude mcp add --transport http marginnote http://127.0.0.1:{port}/bridge/v1/mcp --header "Authorization: Bearer $TOKEN"。工具仅 mn_guide（规程）与 mn_call（{method,path,body} 转发）。GET /mcp 未实现（501），以 POST 通道为准。

Authorization

bearerAuth
AuthorizationBearer <token>

安装脚本写入 ~/.config/mn-bridge/token，或环境变量 MN_BRIDGE_TOKEN。不要带 Origin 头。

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

MCP JSON-RPC 通道，工具仅 mn_guide 与 mn_call（{method,path,body} 转发到同一批端点）。

Response Body

curl -X POST "https://example.com/mcp" \  -H "Content-Type: application/json" \  -d '{}'
Empty

安装码相关 POST

安装辅助路由，无 confirm 门，不轮换 token、不写 Skill 文件。具体语义以运行时 GET /guide 为准；刷新规程只读 GET /guide。

列文档文件夹 GET

?path=&depth=。"" 为根。文件夹与学习集/标签互不影响，挪文件夹不破坏卡片。