Skip to content

Connect an assistant ​

Orbuzo is an MCP server. Any AI assistant that speaks MCP can search and read your library — after you say it may.

The address ​

Every assistant uses the same address: https://orbuzo.ai/api/v1/mcp. The desktop and web apps show it, ready to copy, under Account › AI assistants….

The assistant signs in with OAuth: it sends you to an Orbuzo page that names it and the site it will send you back to. Check both, then click Allow. You do this once per assistant.

Claude ​

  1. In Claude (web or desktop), open Plugins in the sidebar, click Add at the top right, and choose Add custom connector.

  2. Type Orbuzo as the Name and paste the address into MCP server URL:

    text
    https://orbuzo.ai/api/v1/mcp
  3. Click Continue. Claude opens Orbuzo: check the page and click Allow.

Claude Code ​

Run this once:

sh
claude mcp add --transport http orbuzo https://orbuzo.ai/api/v1/mcp

Then type /mcp in Claude Code and choose Orbuzo to sign in.

ChatGPT ​

  1. In ChatGPT's settings, turn on Developer mode (under the advanced settings for apps or connectors).

  2. Add a custom connector, or MCP server. Name it Orbuzo, paste the address, and choose OAuth:

    text
    https://orbuzo.ai/api/v1/mcp
  3. ChatGPT opens Orbuzo. Check the page and click Allow.

  4. In a chat, turn Orbuzo on from the tools menu, and ask about your library.

Others ​

Cursor, VS Code and other assistants that support remote MCP servers with OAuth take the same address and send you to Orbuzo to approve them.

Ending a connection ​

Account › AI assistants… lists every assistant you approved, when it connected and when it last used your library. Disconnect ends one at once; the others keep working.

Access tokens, for programs ​

Some programs cannot sign in with OAuth. For them, make a personal access token under Account › AI assistants… › Access tokens. It is shown once: keep it like a password. You can have up to 20, and revoke any of them.

A program that can send a header sends it as Authorization: Bearer rlp_…. One that can only start a program uses orbuzo-mcp, which comes with the desktop app: it passes messages between the program and Orbuzo using your token.

What an assistant can do ​

Read, nothing else. It can search your library and read items, transcripts and summaries. It cannot import, change or delete anything. See MCP tools.