Skip to main content

Claude: add Sitebulb Desktop MCP (Team plan)

Connect Sitebulb Desktop to Claude on a Team plan. An Owner adds the custom connector once, then teammates enable it and pick the machine running Sitebulb. Sitebulb needs to be open and up to date.

Connecting Sitebulb Desktop to Claude means you can ask Claude about the projects and audits sitting on your own machine, and get answers pulled straight from your crawls.

Claude Individual or Claude Team plan?

Until Sitebulb MCP gets approved by Anthropic in their Directory (which can take ~3-6 months) - you will need to add Sitebulb MCP as a 'Custom Connector', which will look different in Claude whether you have an 'Individual' account or a 'Team' one.

  • If you are part of a Team plan, you need this guide - carry on below.

  • If you have an Individual plan, you need a different guide - please follow this link.

Adding Sitebulb as an app on Claude Team (Owner)

If you're on a Team plan, the steps below can only be carried out by an Owner or Primary Owner.

If you are a 'User' (or an 'Admin'), please send this guide to a Claude Owner within your organisation and ask them to do it for you. Once they've done their bit, you can pick up from this part of the guide to finish off the connection in your Claude.

Open Connector settings

Open up Claude and head to the Connectors page https://claude.ai/new#settings/customize-connectors

Hit Add in the top right hand corner and choose the option Add custom connector from the dropdown.

Note: If you don't see 'Add custom connector', this means you do not have the necessary permissions - you will need to get a Claude Owner to complete these steps before you can proceed.

Add custom connector

A form overlay will appear, and the only fields that you need to fill in are the top two.

Enter the connector name and the MCP server URL:

  • Name: Sitebulb Desktop

  • Remote MCP server URL: https://mcp.sitebulb.com/desktop

Leave the optional OAuth client fields blank, that's deliberate: it lets Claude use Sitebulb's OAuth discovery and dynamic client registration to sort the connection out for you. Just hit Add at the bottom right to complete the process.

This will add the connector, and then the final step is to hit Connect.

Sign in with Sitebulb

Note: If you are the Claude Admin, but you are not actually a Sitebulb user, you can skip this 'Sign in with Sitebulb' step, you will just need to communicate with your team that they can now connect to Sitebulb themselves through Claude.

After you hit Connect, a temporary overlay will appear, then it will automatically open a page in your browser on auth.sitebulb.com - sign in with your Sitebulb credentials (make sure these are the same ones you use to sign into the Sitebulb desktop application).

Check the address first. Only ever sign in at https://auth.sitebulb.com. And don't paste OAuth codes, tokens, or one-time codes into the chat, nothing legitimate will ask you to.

Once you've signed in, you'll need to choose the 'target', which is simply the name of the desktop/laptop computer running Sitebulb (most people will only have one option here).

On the review page, you'll need to hit Allow in order to give Sitebulb the read-only access it needs for MCP.

Start chatting with Sitebulb

Once permission is granted and you return to Claude, you can confirm that the Sitebulb Desktop Connector is available if you hit the + button at the bottom left of the chat box, and scroll down to view 'Connectors'.

In the chat box, ask a simple prompt to check it's working:

Share with your team

You've completed the setup steps which means that Sitebulb Desktop will be available within your Claude workspace for your whole team, however they still need to individually connect and authorise the connector. Send them to the document below as this covers the steps they need to complete (handy jump link here).

Adding Sitebulb as a connector on Claude Team (User/Admin)

If you're on a Team plan, the steps above can only be carried out by an Owner. If you are a 'User' or 'Admin', you will not be able to create the custom app, so please send this guide to a Claude Owner within your organisation and ask them to do it for you.

Once you've been told that these steps are completed, you should be able to proceed on your own.

Enable Sitebulb Desktop Connector

Open up Claude and head to the Connectors page https://claude.ai/new#settings/customize-connectors

Hit Browse and then search for 'Sitebulb Desktop' in the listings.

Click through to the directory listing and then hit Connect.

Sign in with Sitebulb

A temporary overlay will appear, then it will automatically open a page in your browser on auth.sitebulb.com - sign in with your Sitebulb credentials (make sure these are the same ones you use to sign into the Sitebulb desktop application).

Check the address first. Only ever sign in at https://auth.sitebulb.com. And don't paste OAuth codes, tokens, or one-time codes into the chat, nothing legitimate will ask you to.

Once you've signed in, you'll need to choose the 'target', which is simply the name of the desktop/laptop computer running Sitebulb (most people will only have one option here).

On the review page, you'll need to hit Allow in order to give Sitebulb the read-only access it needs for MCP.

Start chatting with Sitebulb

Once permission is granted and you return to Claude, you can confirm that the Sitebulb Desktop Connector is available if you hit the + button at the bottom left of the chat box, and scroll down to view 'Connectors'.

In the chat box, ask a simple prompt to check it's working:

Troubleshooting

  • If you don't see Sitebulb in the list of available connectors in your chat, you may need to hard refresh Claude and/or run the sign-in process again - sometimes Claude has issues syncing recent connectors.

  • If you use Claude's desktop app, connections can be quite fragile (this is a Claude thing not a Sitebulb thing) - generally reloading or restarting the app fixes any connection issues.

  • If you don't see any desktop targets, check you are running the latest version of Sitebulb desktop (and that Sitebulb is actually open), and you are signing in with the correct account (in the Sitebulb desktop application, go to 'Your Account' in the top right to check the email address you are signed in with).

Did this answer your question?