Connect common.ink to your AI tools

Add persistent memory and live deployment capabilities in minutes.

Before you start

  1. 1. A common.ink account — Sign up or Sign in

All clients below use OAuth — no API key needed. You can optionally create an API key for scripts or custom integrations.

ChatGPT

Requires a paid ChatGPT plan (Plus, Pro, Team, or Enterprise). No API key needed — ChatGPT uses OAuth to connect.
  1. Open ChatGPT at chat.openai.com
  2. Click your profile icon (bottom-left)
  3. Go to Settings > Connectors
  4. Enable Developer Mode (under Advanced settings)
  5. Click "Create" to add a new connector
  6. Fill in the connector details:
    Name common.ink
    Description Persistent memory and live apps for your AI workflows
    Connector URL https://common.ink/mcp
  7. Set Authentication to "OAuth"
  8. Click Create — you'll be redirected to common.ink to log in and authorize access
Then in any conversation, click "+" > "More" to select common.ink from your connectors.

Claude Web (claude.ai)

Requires a Claude Pro, Max, Team, or Enterprise plan. No API key needed — Claude uses OAuth to connect.
  1. Open claude.ai and click your profile icon, then Settings
  2. Click Connectors in the left sidebar
  3. Scroll down and click "Add custom connector"
  4. Enter the MCP server URL:
    https://common.ink/mcp
  5. Click "Add" — Claude will discover the OAuth endpoints automatically
  6. You'll be redirected to common.ink to log in and authorize access
  7. Back in Claude, click "+" in the chat composer, then "Connectors" to enable it

Claude Code (CLI)

No API key needed — Claude Code supports OAuth natively.

Run one command:

claude mcp add --transport http commonink https://common.ink/mcp

Then type /mcp to authenticate. Claude Code will open a browser window for you to log in and authorize access.

Example session:
$ claude mcp add --transport http commonink https://common.ink/mcp
Added HTTP MCP server commonink with URL: https://common.ink/mcp

$ claude
> /mcp
Authentication successful. Connected to commonink.

> show me my notes
# Claude lists your notes via the note_list tool

Claude Desktop App

No API key needed — Claude Desktop uses mcp-remote which handles OAuth automatically.
  1. Open Claude Desktop
  2. Click the Claude menu in your menu bar (macOS) or system tray (Windows)
  3. Go to Settings > Developer
  4. Click "Edit Config" to open claude_desktop_config.json
  5. Add this configuration:
    {
      "mcpServers": {
        "common-ink": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://common.ink/mcp"]
        }
      }
    }
  6. Restart Claude Desktop completely (quit and relaunch)
  7. A browser window will open for you to log in and authorize access
  8. Look for the MCP tools icon in the bottom-right of the input box

Config file locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Other MCP Clients

For any MCP-compatible client, use these connection details:

MCP Endpoint https://common.ink/mcp
Transport Streamable HTTP
Authentication OAuth 2.1 with PKCE (auto-discovered) or Bearer token (API key)
OAuth Discovery https://common.ink/.well-known/oauth-protected-resource

Clients that support OAuth 2.1 (like ChatGPT and Claude) will auto-discover endpoints and handle authentication. For clients that don't support OAuth, use an API key as a Bearer token.