Skip to main content
Connect Onsomble to Claude and you can run your AI discoverability work by talking to it: set up a Site, add the prompts you track, run a Scan, or ask how you are showing up in AI answers. Claude does the work in your account and reports back. The connection is one address:
You sign in to Onsomble the first time you connect, so no keys change hands. For scripts and automated setups, use an API key instead.

​
Claude Desktop and Claude.ai

The steps are the same in the desktop app and on Claude.ai. In a Team or Enterprise workspace, an Owner or Primary Owner must first add Onsomble under Organization settings → Connectors. Enterprise users with the Manage access to Libraries permission can also add it. Members then connect to Onsomble individually.
1

Open connector settings

Go to Customize → Connectors and choose Add custom connector. In a workspace, select the Onsomble connector your organisation has already added and choose Connect instead.
2

Paste the connection

When adding a new connector, paste the address above, name it Onsomble, and add it. Skip this step if you selected an existing workspace connector.
3

Sign in and approve

Choose sign in now, sign in to Onsomble in the browser that opens, and approve access. Claude marks the connector as connected.
Anthropic’s own guide: Custom connectors and account requirements.

​
Claude Code

Add the server with one command:
1

Authenticate

Type /mcp, select Onsomble, and choose Authenticate.
2

Approve

Sign in to Onsomble in the browser that opens and approve access.
Anthropic’s own guide: Connect to remote MCP servers in Claude Code.

​
Use it

Name Onsomble in your first message and name the Site you mean. A few to start with are on the overview. To make Claude read the results like an analyst, install the Onsomble skills alongside the connection.

​
API keys for scripts and CI

For an automated setup, a shared repository, or the Claude API, authenticate with an Onsomble API key instead of signing in. Create one in Settings → Account → API Keys: see the API overview. Keys start with ons_ and are shown once at creation.

​
Claude Code, shared across a repository

Commit a .mcp.json at the project root and keep the key in an environment variable, so nothing secret lands in the file:
Each developer sets ONSOMBLE_API_KEY in their shell.

​
The Claude API

Attach the server to a Messages API call with the MCP connector. Anthropic’s platform makes the tool calls; you never proxy the traffic.
Onsomble MCP can read results and, with the required permissions, change Clients, Sites, scan configuration and schedules. Starting a Scan uses scan allowance. In an automated integration, restrict tools to the reads you need or require user confirmation before executing write actions. The tools available to a connection depend on its permissions.