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 listed in Claude’s connector directory, so on most plans it is added with a single click. Who adds it depends on your Claude plan:
  • Free, Pro, and Max — you add Ruddr yourself.
  • Team and Enterprise — an organization owner or admin enables Ruddr once, and it then appears for every member to connect.
Claude Code is separate from all of this and is covered further down.

Adding Ruddr from the Connector Directory

This is the route on a Free, Pro, or Max plan, and for a Team or Enterprise member whose admin has already enabled Ruddr.
  1. Go to Customize > Connectors in Claude.
  2. Choose Discover.
  3. Find Ruddr, either by searching for it or by browsing the Productivity category.
  4. Open it and click Connect to Claude (Figure 1).

Figure 1 - Ruddr in Claude's Connector Directory

Claude then sends you to Ruddr to sign in and approve the connection, which is covered under Connecting below. Once you approve, the page shows Connected (Figure 2).

Figure 2 - Ruddr Connected to Claude

Ruddr carries a Community badge in the directory. That means Anthropic reviewed the connector automatically but does not verify it; Ruddr publishes and maintains it.

Enabling Ruddr for a Team or Enterprise Organization

Members of a Team or Enterprise organization cannot connect Ruddr until an owner or admin enables it for the organization. The owner goes to Customize > Connectors, chooses Discover, opens Ruddr, and clicks Connect for your team (Figure 3).

Figure 3 - Enable Ruddr for a Whole Claude Organization

Enabling Ruddr is a one-time setup in Claude and does not give anyone access to Ruddr data on its own. Ruddr then appears under Customize > Connectors for every member, each of whom connects with their own Ruddr sign-in.

Adding Ruddr as a Custom Connector

Use this route if Ruddr does not appear in the directory for your organization or region, or if your admin would rather manage it as a custom connector. Both routes reach the same server and behave identically. You enter the Ruddr server address yourself:
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.
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.
A Free plan is limited to one custom connector in total.
For a Team or Enterprise Organization
An owner does this once for the whole organization. Individual members cannot add custom connectors themselves.
  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.