Setting Up the MCP Connection

Connecting your AI assistant to VerseDB takes a few minutes. Once set up, you can manage your comics through natural conversation.## Adding VerseDB to Claude Desktop

To connect VerseDB to Claude Desktop:

1. Go to Customize > Connectors in the sidebar, or go directly to claude.ai/customize/connectors
2. Click the + icon to add a custom connector
3. Enter VerseDB as the name and https://versedb.com/mcp/api as the Remote MCP server URL
4. Click Add

The first time you ask Claude to do something with VerseDB (like searching for a series), your browser will open to a VerseDB login page. Sign in, click Authorize, and you're connected. The token is stored automatically and refreshes on its own, so you won't need to sign in again.

If you prefer editing the config file directly, add this to your Claude Desktop config (on Mac: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "versedb": {
      "url": "https://versedb.com/mcp/api"
    }
  }
}

Adding VerseDB to Claude Code#

Add this to your project's .mcp.json file:

{
  "servers": {
    "versedb": {
      "type": "http",
      "url": "https://versedb.com/mcp/api"
    }
  }
}

Claude Code will prompt you to authorize through your browser on first use.

Other MCP Clients#

Any MCP-compatible client can connect using:

• Server URL: https://versedb.com/mcp/api
• Authentication: OAuth 2.0 (discovery at https://versedb.com/oauth)
• Transport: Streamable HTTP

Refer to your client's documentation for how to add a remote MCP server.

How Authorization Works#

1. You use any VerseDB tool for the first time (e.g., "Search for Batman")
2. Your browser opens to the VerseDB login page
3. Sign in and click Authorize
4. Done. All future requests work automatically.

The token refreshes on its own. You won't need to re-authorize unless you revoke access.

Verifying the Connection#

Try a test prompt:

"Search for Batman series on VerseDB"

If everything is working, Claude will return a list of Batman-related series from the database.

Disconnecting#

To revoke access, remove the VerseDB server from your client's settings. You can also revoke OAuth tokens from your VerseDB account settings under Connected Apps.