UrbaHive Guide
FR

AI assistant

Connect Claude to UrbaHive

On this page

Connecting Claude takes two parts: a personal access token that you create in UrbaHive, then the UrbaHive connector that you add in Claude. Everything starts in Personal Settings › Connectors. Any member can do it, whatever their role; what Claude may then change depends on that role.

The Connectors tab of Personal Settings: the endpoint, the New token button, the token list and the connection instructions.

The Connectors tab: the endpoint, your tokens, and the instructions for each Claude application.

  1. Endpoint: the address Claude calls
  2. New token
  3. Your tokens
  4. How to connect Claude

Create a token

  1. Open Personal Settings in the sidebar, then the Connectors tab.
  2. Click New token. The window "New MCP token" opens.
  3. Give the token a Name that says where you will use it, for example "My Mac (Claude Desktop)".
  4. Check the Target organization. "The token grants access to this organization only, even if you are a member of several." The current organization is selected.
  5. Set Expires in (days): 90 by default, up to 365.
  6. Leave Allow write access off for a read-only token ("the client can only read data (recommended)"). Turn it on only if you want Claude to create and change data.
  7. Click Generate. The window becomes "Copy your token now".
  8. Copy the token and store it in your password manager, or paste it straight into Claude. "This token will never be shown again."
  9. Click Done.

If something is missing, the window says "Please give the token a name" or "Pick a target organization".

The New MCP token window with a name, the target organization, the expiry and the write access switch off.

The New MCP token window with a sample name, read-only by default.

  1. Name
  2. Target organization: one per token
  3. Expires in (days): 90 by default, up to 365
  4. Allow write access: off means read-only
  5. Generate

Warning

Treat a token like a password. Anyone who has it can act in UrbaHive as you, within the token's limits. Never paste it in a shared document, a ticket or a chat with other people. If it leaks, revoke it at once: see Permissions, tokens and safety.

The endpoint

The Endpoint row at the top of the tab gives the address Claude must call. Click Copy endpoint to copy it.

  • On the hosted service, it is https://app.urbahive.com/api/mcp.
  • On an on-premise installation, it is your UrbaHive address followed by /api/mcp.

The section "How to connect Claude", lower in the tab, has one tab per Claude application, with the endpoint already filled in.

Claude Desktop

  1. Open the Claude Desktop configuration file, claude_desktop_config.json. On macOS, it is in ~/Library/Application Support/Claude/. On Windows, it is in %APPDATA%\Claude\.
  2. Copy the snippet from the Claude Desktop tab in UrbaHive, paste it in the file, and replace the placeholder after "Bearer" with your token.
  3. Save the file.
  4. Quit Claude Desktop completely (⌘Q on a Mac) and start it again. Closing the window is not enough: "a plain close doesn't reload the config".

The snippet starts a small bridge, mcp-remote, with npx. Node.js must therefore be installed on the computer. Ask your IT team if it is not.

The Claude Desktop instructions: where the configuration file is, and the snippet to paste.

The Claude Desktop tab: where the configuration file is, and the snippet to paste.

  1. Claude Desktop, claude.ai (web), Claude Code, Verify
  2. The configuration file to open
  3. Snippet to paste, then put your token

claude.ai

  1. In claude.ai, open Settings, then Connectors.
  2. Click Add custom connector.
  3. For the URL, paste the endpoint.
  4. For the authentication header, use Authorization: Bearer followed by your token.

claude.ai only accepts HTTPS addresses. The claude.ai (web) tab in UrbaHive shows the exact values to use.

The claude.ai instructions: add a custom connector with the endpoint and an Authorization header.

The claude.ai (web) tab: add a custom connector with the endpoint and an Authorization header.

  1. claude.ai (web)
  2. Settings, Connectors, Add custom connector
  3. HTTPS addresses only

Note

On an on-premise installation, the claude.ai (web) tab appears only when the installation can be reached from the Internet over HTTPS.

Claude Code

The Claude Code tab gives one command to run in a terminal, with the endpoint filled in:

claude mcp add --transport http urbahive <endpoint> --header "Authorization: Bearer <your token>"

Replace the token placeholder with your token. Then run claude mcp list to check that UrbaHive is loaded.

Check the connection

Ask Claude: "Which organization are you connected to?" It should name the organization of your token, your role, and whether the token can write.

The Verify tab explains a more technical test with the MCP Inspector, for IT teams who want to check the endpoint before connecting Claude.

Once Claude has made its first call, your token shows when it was last used, and the dashboard's MCP connectors card shows the last call.

Next