Quick Start

Step 1: Configure the MCP endpoint

Add an HTTP MCP server in your MCP client and point it to:

https://your-domain/api/mcp

For local development:

http://localhost:3000/api/mcp

Step 2: Add client configuration

A common configuration looks like this:

{
  "mcpServers": {
    "open-history": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://your-domain/api/mcp"],
      "env": {
        "MCP_OPEN_API_USER_ID": "your-user-id",
        "MCP_OPEN_API_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----",
        "MCP_SESSION_COOKIE": "next-auth.session-token=..."
      }
    }
  }
}

Notes:

• For public OpenAPI tools only, MCP_OPEN_API_USER_ID and MCP_OPEN_API_PRIVATE_KEY are enough.
• Admin APIs also require MCP_SESSION_COOKIE.

Step 3: Verify the connection

Call api_open_documents_get first to verify that the full chain is working.