Getting Started

Connect your AI assistant to Multiplist in under 5 minutes. Install @multiplist/mcp-server via npm or connect directly over StreamableHTTP — then make your first vault search.

# Connect via MCP

Multiplist works as an MCP server. Connect from Claude Desktop, Claude Code, ChatGPT, or any MCP-compatible client.

• Endpoint: https://multiplist.ai/mcp
• Transport: StreamableHTTP + OAuth 2.1 with PKCE
• npm: @multiplist/mcp-server@1.0.0

# Claude Desktop — Option A: Remote (recommended)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "multiplist": {
      "type": "streamable-http",
      "url": "https://multiplist.ai/mcp"
    }
  }
}

Transport: StreamableHTTP + OAuth 2.1 with PKCE. On first use, Claude opens the Multiplist login page in your browser — the token is stored automatically. No API keys to manage.

# Claude Desktop — Option B: Local bridge via npm

Install the bridge globally:

npm install -g @multiplist/mcp-server

Then add this to claude_desktop_config.json:

{
  "mcpServers": {
    "multiplist": {
      "command": "npx",
      "args": ["-y", "@multiplist/mcp-server"],
      "env": {
        "MULTIPLIST_API_KEY": "your-key-here"
      }
    }
  }
}

Generate your API key in Settings → API Keys inside the Multiplist app. The bridge forwards every call to https://multiplist.ai/mcp — no local database required.

# Claude Code

One command:

claude mcp add multiplist --transport streamable-http https://multiplist.ai/mcp

Claude Code handles OAuth automatically. When the server requires authentication, your browser opens the login page and the token is stored for future sessions.

# ChatGPT

ChatGPT connects through the Apps & Connectors interface.

1. Open ChatGPT → Settings → Apps & Connectors.
2. Click Add and enter the URL https://multiplist.ai/mcp/chatgpt.
3. Set the auth method to OAuth and click Create.
4. Log in with your Multiplist account.

# Your first search

Once connected, try these prompts to verify everything works:

• "Search my Multiplist vault for recent notes" → triggers search_vault.
• "Give me an overview of my vault" → triggers get_vault_summary.
• "Import this text into my vault: [paste content here]" → triggers create_source.

# Key concepts

• Sources — the atomic unit of imported content. Conversations, documents, transcripts, notes.
• Seeds — structured insights extracted from sources. Nine categories: decisions, frameworks, golden passages, definitions, exemplars, actions, questions, offers, emergence.
• Containers — top-level domains for organizing studios.
• Studios — focused workspaces where active work happens on a specific topic.
• Extraction — the semantic engine that reads sources and produces categorized, cited seeds.
• Skills — custom extraction recipes you define. Tell Multiplist what to look for in your specific content type.

# Authentication

Multiplist supports two authentication methods:

MCP tokens use the mp_live_ prefix, are SHA-256 hashed at rest, and support scoped permissions. Tokens are shown only once at creation — store them securely.

# Next steps

• MCP Tool Flow Map — every tool mapped by intent.
• MCP Tools Reference — parameter-level detail for every tool.