
How to add Last9 MCP Server to Claude Desktop
Connect AI to Last9 production observability: logs, metrics, traces, exceptions and alerts. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 15, 2026 ยท 90โ ยท stdio ยท apikey ยท official
Claude Desktop config for Last9 MCP Server
npx -y @last9/mcp-server@latest{
"mcpServers": {
"last9-mcp-server": {
"command": "npx",
"args": [
"-y",
"@last9/mcp-server@latest"
],
"env": {
"LAST9_REFRESH_TOKEN": "<your-refresh-token>"
}
}
}
}Setup steps
- 1Open Claude Desktop โ Settings โ Developer โ Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the Last9 MCP Server config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm Last9 MCP Server's tools appear under the ๐ tools menu.
Before you start
- A Last9 account (app.last9.io) with admin access โ only admins can generate API tokens
- For self-hosted stdio: a Last9 refresh/access token from Settings โ API Access (app.last9.io/settings/api-access), generated with Write permission, set as LAST9_REFRESH_TOKEN
- For self-hosted: the binary via Homebrew (brew install last9/tap/last9-mcp), npm (npm install -g @last9/mcp-server@latest), or a GitHub release download (macOS/Linux/Windows, x64/ARM64)
- For hosted HTTP: your Last9 org slug from the app URL and an MCP client that supports OAuth (Claude, Cursor, VS Code 1.99+, Windsurf)
What Last9 MCP Server can do in Claude Desktop
get_service_summaryHigh-level health summary for a service
get_exceptionsList server-side exceptions for a service/time range
get_logsQuery logs across the platform
get_service_logsFetch logs scoped to a specific service
get_tracesRetrieve distributed traces
prometheus_range_queryRun a PromQL range query over metrics
prometheus_instant_queryRun a PromQL instant query
get_database_slow_queriesSurface slow database queries
Security
The refresh token authenticates to your full Last9 org telemetry, so store it securely and prefer the hosted OAuth endpoint where no static token is stored locally. Limit LAST9_MAX_GET_LOGS_ENTRIES to avoid pulling excessive log volume into the model context.
Last9 MCP Server + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Last9 MCP Server config there under the "mcpServers" key and restart the client.
Is Last9 MCP Server safe to use with Claude Desktop?
The refresh token authenticates to your full Last9 org telemetry, so store it securely and prefer the hosted OAuth endpoint where no static token is stored locally. Limit LAST9_MAX_GET_LOGS_ENTRIES to avoid pulling excessive log volume into the model context.
How do I authenticate?
Either use the hosted HTTP transport with OAuth (no token to manage), or self-host the stdio binary with a LAST9_REFRESH_TOKEN. Only Last9 admins can generate the token from Settings โ API Access.
Do I need to install anything for the hosted version?
No. The hosted HTTP transport requires no binary and no token โ you add the org-scoped MCP URL and authenticate via OAuth in your client.
Which MCP clients are supported?
Claude (Code/Desktop/Web), Cursor, VS Code 1.99+, and Windsurf are documented as supported clients.