MCP Integration

Sidenote ships a Model Context Protocol (MCP) server that lets AI agents upload documents, read reviewer feedback, and push updated versions — all without a human at the API layer.

This guide shows you how to connect your MCP-compatible agent to Sidenote and run a full human-in-the-loop review cycle.

Requirements

• Plan: MCP access requires a Pro or Team plan.
• Auth: Agents authenticate via OAuth 2.1 with PKCE — no API keys or shared secrets.
• Endpoint: MCP server URL: https://sidenote.ink/api/mcp
• Protocol: JSON-RPC 2.0 over HTTP POST with Bearer token authentication.

Connecting your MCP client

Most MCP-compatible clients (Claude Desktop, Cursor, Windsurf, and custom agents) handle the OAuth flow automatically once you point them at the Sidenote MCP URL.

Add Sidenote to your MCP client configuration:

{
  "mcpServers": {
    "sidenote": {
      "url": "https://sidenote.ink/api/mcp"
    }
  }
}

On first connection, your client will:

1. Open a browser window.
2. Ask you to sign in to Sidenote.
3. Request authorization for the agent.

After that, access and refresh tokens are managed automatically by the client.

If your client needs the full OAuth discovery URL, use:

• OAuth metadata: https://sidenote.ink/.well-known/oauth-authorization-server

Available MCP tools

Once connected, your agent can call these tools over MCP.