Skip to main content
NOTE: The Ruddr Assistant feature must be enabled in workspace settings in order for this to be available in your workspace. Claude reaches outside services through connectors. Ruddr is not in Claude’s connector directory, so it is added as a custom connector using the Ruddr server address:
Who does that depends on your Claude plan:
  • Free, Pro, and Max — you add the connector yourself. A Free plan is limited to one custom connector in total.
  • Team and Enterprise — individual members cannot add custom connectors. An organization owner adds Ruddr once, and it then appears for every member to connect.
Claude Code is separate from all of this and is covered further down. Claude’s settings change from time to time, so treat Anthropic’s own Get started with custom connectors using remote MCP article as the authority on the screens themselves — what follows is what to enter when you get there.

​
Adding Ruddr on a Free, Pro, or Max Plan

  1. Go to Customize > Connectors in Claude.
  2. Click +, then Add custom connector.
  3. Enter Ruddr as the name and the Ruddr server address as the URL.
  4. Leave the authentication settings as Claude detects them. Ruddr publishes its own sign-in requirements, so there is no OAuth client ID or secret for you to create.
  5. Click Add.

​
Adding Ruddr for a Team or Enterprise Organization

An owner does this once for the whole organization. It is a one-time setup in Claude and does not give anyone access to Ruddr data on its own.
  1. Go to Organization settings > Connectors in Claude.
  2. Select Add, then Custom. If Claude asks for the connector type, choose Web.
  3. Enter Ruddr as the name and the Ruddr server address as the URL.
  4. Leave the authentication settings as Claude detects them. If you are asked how Claude should identify itself, Use Anthropic’s hosted client metadata is the option Ruddr supports and the one to choose.
  5. Click Add.
Ruddr then appears in your organization’s connector list, labeled Custom. Removing it there takes it away from everyone.

​
Connecting

However the connector was added, each member connects individually. Go to Customize > Connectors, find Ruddr, and click Connect. Claude sends you to Ruddr to sign in and approve the connection — see Connecting an Application for what that screen is asking. A member can only connect if they have the Ruddr Assistant enabled on their member profile, and once connected they see exactly the data their security role allows. Members of your Claude organization who are not members of your Ruddr workspace cannot connect at all.

​
Using Ruddr in a Conversation

Connectors are turned on per conversation. Click the + button in the chat, choose Connectors, and switch Ruddr on. Claude will then use it when your question calls for it — asking about a client’s budget, this week’s hours, or an unbilled balance, for example.

​
Claude Code

Claude Code runs in your terminal and is configured with two commands rather than through the connector settings. For anything about Claude Code itself, see Anthropic’s own MCP documentation for Claude Code. Add the Ruddr server:
--scope user makes Ruddr available in every project you work on. Leave it off if you only want Ruddr in the project folder you are currently in. Then start Claude Code and run the /mcp command, select ruddr, and choose the authenticate option. Claude Code opens your browser, where you sign in to Ruddr and approve the connection. If you are working over SSH or on a machine with no browser, authenticate from the command line instead:
Claude Code prints an authorization link rather than opening one. Open it on a device where you can sign in to Ruddr, approve the connection, and paste the address you land on back into the terminal when prompted. To confirm Ruddr is configured and reachable, run claude mcp list. To remove it, run claude mcp remove ruddr.

​
Removing the Connection

Removing the connector, or running claude mcp remove, stops Claude from using Ruddr. The authorization itself lives in Ruddr, so to revoke it there as well, delete the connection from your Connected Apps page.