How to Integrate Observe with AWS DevOps Agent via Custom MCP Server

Select Language:

To set up an integration with Observe’s AI features using your AWS DevOps Agent, you’ll need to go through several steps. Here’s a simple guide to help you do that smoothly.

First, ensure you have the right prerequisites. On the AWS side, you need an active AWS DevOps Agent Space and access to its console, specifically the Capability Providers section. On the Observe side, you must have an account with AI features enabled and gather your MCP endpoint URL, which should follow this format: https://.observeinc.com/v1/ai/mcp. To find your customer ID, log into Observe and navigate to Admin → Customer Settings; the ID appears in the “ID” field. Alternatively, you can look at your browser URL when logged in.

Next, generate an API token in Observe. To do this, go to your user menu in Observe, then Manage account, and select “My API tokens.” Click “Create API Token,” give it a name like “devops-agent-mcp,” set an expiration time if needed, and then copy the token value. Your authorization header will be structured as: Bearer .

Before proceeding, verify that your MCP endpoint is reachable from your terminal. Use a curl command like this:

curl -v -X POST https://.observeinc.com/v1/ai/mcp \
-H “Content-Type: application/json” \
-H “Authorization: Bearer ” \
-d ‘{“jsonrpc”:”2.0″,”method”:”initialize”,”id”:1,”params”:{“protocolVersion”:”2024-11-05″,”capabilities”:{},”clientInfo”:{“name”:”test”,”version”:”1.0″}}}’

If you get a valid JSON-RPC response or any server response, your endpoint is active.

Now, register the MCP server in your AWS DevOps Agent. You can do this via the console by opening the AWS DevOps Agent console, navigating to Capability Providers, and clicking Register under MCP Server. Fill in the details: name it “observe-mcp,” provide the endpoint URL, enable “Dynamic Client Registration,” choose “API Key” as the auth type, set the header as “Authorization,” and use the Bearer token as the API key value. Click Register to complete the setup.

Alternatively, if you prefer using the command line interface, run a command like:

aws devops-agent register-service \
–service mcpserver \
–service-details ‘{
“mcpserver”: {
“name”: “observe-mcp”,
“endpoint”: “https:///v1/ai/mcp”,
“description”: “Observe observability platform MCP server”,
“authorizationConfig”: {
“apiKey”: {
“apiKeyName”: “observe-api-key”,
“apiKeyValue”: “Bearer “,
“apiKeyHeader”: “Authorization”
}
}
}
}’ \
–region us-east-1

Once registered, your DevOps Agent will automatically discover available Observe tools, such as dataset search, metric search, service map generation, and alert monitoring. These tools are read-only, so it’s safe to enable all of them in your setup.

The next step is to add the MCP server to your specific Agent Space. In your Agent Space’s settings, go to View Details, then the Capabilities tab. Under MCP Servers or Telemetry, click Add, select “observe-mcp,” and save. You’ll also see options for a Webhook URL and Secret, which can be used for automatic triggers—save these if needed.

Finally, test your setup. Open your Agent Space chat and ask simple questions like: “List monitors in Observe,” “Search for metrics in Observe,” “Generate a service map from Observe,” or “Search for recent alerts in Observe.” If responses come back as expected, your integration is successful and ready to use.

And that’s it! You now have a working connection between AWS DevOps and Observe, opening up new insights and automation opportunities.