📘
Note
Model Context Protocol (MCP) is in private preview. Contact your Observe representative for more information or open Help > Contact support in the product and let us know.

Model Context Protocol (MCP) is an open standard for sharing context between AI models and data systems.

The Observe MCP Server lets agentic tools such as Augment, Cursor, Claude Code, and Claude Desktop connect securely to your Observe tenant so they can investigate incidents, or explore logs, metrics or traces.

Prerequisites

Verify that the requirements in this section are met before using MCP server.

Required permissions

MCP requires the following minimum RBAC permissions:

Object	Permission	Why it’s required
Authtokens	Create	Lets you generate the API token that external agentic tools use to authenticate to the MCP Server.

You can grant this permission by adding the built-in writer role, or by creating or editing a custom group.

Add the built-in writer role

The writer role already includes Authtokens → Create and other write-level privileges, so assigning it to a user or service account is the quickest path.

Create or edit a custom group

Perform the following steps to create or edit a custom group:

Click on your user name in the left navigation rail and select Manage account.
Click Groups.
Select the Create checkbox for Authtokens. No other permissions are strictly needed for basic MCP usage.
Add the users or service accounts that will run the agent/tool to this group.

If your account can’t create Authtokens, ask an Observe administrator to assign the writer role or grant the permission through a custom group.

Install Node.js

The Observe MCP Server requires Node.js v18 or higher.

Run the following commands:

brew update
brew install node
brew upgrade node
node -v

📘
Note
If you have multiple versions of Node.js installed, most MCP clients will use the system version that appears first in your PATH. Make sure the system version is 18 or higher.

Configure the Observe MCP server

Perform the following steps to configure the MCP server in Observe:

Click on your user name in the left navigation rail and select Manage account.
Click MCP Server details.
Pick your tool of choice.
Configure the tool to connect to the Observe MCP Server.
Restart your tool.
Start asking questions! For example: What are the top 5 errors in my application? Use the Observe MCP Server to answer the question.

Troubleshooting

When configuring Cursor, you may see the following messages in your Cursor's MCP list:

[error] No server info found
[info] Handling ListOfferings action, server stored: false 
[info] Server not yet created, returning empty offerings
[info] Handling GetInstructions action

If you do, perform the following steps:

Run the following commands to clear the NPX cache:
```
rm -rf ~/.npm/_npx  
npm cache clean --force
```
Restart your Cursor app.