How do I integrate Observe with AWS DevOps Agent via custom MCP server?

Prerequisites

AWS Side

• An active AWS DevOps Agent Agent Space
• Access to the AWS DevOps Agent console (Capability Providers section)

Observe Side

• An Observe account with AI features enabled
• The Observe MCP endpoint URL: https://<customer-id>.observeinc.com/v1/ai/mcp
• A valid API token (generated via Observe UI: Manage Account → My API Tokens)

Note: If the user is unable to create an API token, their Observe group needs the "Authtokens → Create" permission. This can be granted via a custom group with just that checkbox selected, or by assigning the built-in writer role.

Observe Knowledge Graph

• Observe maintains a Knowledge Graph (AI-first vector store) that indexes datasets, metrics, traces, and their relationships
• This is auto-populated — no manual intervention needed
• MCP tools query this Knowledge Graph, not the raw datasets directly
• Once AI features are enabled and data is flowing, the Knowledge Graph will be populated automatically

Step-by-Step Integration

Step 1: Obtain the Observe MCP Endpoint URL

Your Observe MCP endpoint follows this format:

https://<customer-id>.observeinc.com/v1/ai/mcp

To find your customer ID:

1. Log into Observe
2. Navigate to Admin → Customer Settings
3. The "ID" field is your customer ID (e.g., 123456789012)

Alternatively, check your browser URL — it will be https://<customer-id>.observeinc.com/...

Step 2: Generate an API Token

1. In Observe, click your username in the left navigation rail → Manage account
2. Click "My API tokens"
3. Click "Create API Token"
4. Name: devops-agent-mcp
5. Set expiration as appropriate
6. Copy the token value

Your authorization header value will be: Bearer <customer-id> <token>

Step 3: Verify the MCP Endpoint is Reachable

Test connectivity from your terminal:

curl -v -X POST https://<customer-id>.observeinc.com/v1/ai/mcp
-H "Content-Type: application/json"
-H "Authorization: Bearer <customer-id> <token>"
-d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Expected response: A valid JSON-RPC response (HTTP 200 or 406). Any response from the server confirms the endpoint is active.

Step 4: Register the MCP Server in DevOps Agent

Via Console:

1. Open the AWS DevOps Agent console
2. Navigate to Capability Providers
3. Find "MCP Server" → Click Register
4. Fill in:
   • Server Name: observe-mcp
   • Endpoint URL: https://<customer-id>.observeinc.com/v1/ai/mcp
   • Check "Enable Dynamic Client Registration"
   • Auth type: API Key
   • API Key Header: Authorization
   • API Key Value: Bearer <customer-id> <token>
5. Click Register

Via AWS CLI:

aws devops-agent register-service
--service mcpserver
--service-details '{ "mcpserver": { "name": "observe-mcp", "endpoint": "https://<endpoint>/v1/ai/mcp", "description": "Observe observability platform MCP server", "authorizationConfig": { "apiKey": { "apiKeyName": "observe-api-key", "apiKeyValue": "Bearer <customer-id> <token>", "apiKeyHeader": "Authorization" } } } }'
--region us-east-1

Step 5: Select MCP Tools

After registration, DevOps Agent will discover available tools. For Observe, these include:

All 10 tools are read-only and safe to enable. Select all and save.

Step 6: Add MCP to Your Agent Space

1. Go to your Agent Space → View Details
2. Select the Capabilities tab
3. Under MCP Servers or Telemetry, click Add
4. Select observe-mcp → Save
5. Note the Webhook URL and Secret (optional — for Observe to auto-trigger investigations)

Step 7: Test the Integration

Open your Agent Space chat and ask:

• "List monitors in Observe"
• "Search for metrics in Observe"
• "Generate a service map from Observe"
• "Search for recent alerts in Observe"