# Configure Claude for Tellagen Diagnosis

Add the Tellagen MCP server to Claude Code and check its tools from Tellagen.

## Before you start

### Intended audience

Responders who use Claude Code for local incident investigations.

### Required permissions

You need a Tellagen API key with the Local Diagnosis preset. The API key owner needs an active responder seat.


### Prerequisites

- Install Claude Code.
- Create and store a [Tellagen Local Diagnosis API key](https://tellagen.com/help/manage-api-keys#step-create-and-store-the-token).

## Procedure

<a id="phase-configure-the-client"></a>

### Configure the client

<a id="step-select-claude"></a>

1. **Select Claude.** Open Settings. The Settings navigation label is Local investigation tools. The page heading is AI diagnostics. Select Claude.

<a id="step-copy-the-install-command"></a>

2. **Copy the install command.** Find the Tellagen MCP card. Select Copy.

![Local investigation tools page with Claude selected and the Tellagen MCP install command.](https://tellagen.com/help/assets/claude-mcp-setup-command-2026-08-29.webp)

Use the command shown for Claude, then check the installed tools.

<a id="step-add-the-mcp-server"></a>

3. **Add the MCP server.** Run claude mcp add with the copied environment values and stdio command. Claude stores the server configuration.

Claude command with safe placeholders:

```shell
claude mcp add tellagen \
  --transport stdio \
  --env TELLAGEN_API_KEY=tllg_YOUR_TOKEN \
  --env TELLAGEN_API_URL=https://YOUR_WORKSPACE.api.tellagen.com \
  --env TELLAGEN_MCP_CLIENT=claude \
  -- npx -y @tellagen/mcp-server@latest
```

<a id="step-add-required-provider-tools"></a>

4. **Add required provider tools.** Install only the provider tools that the incident needs. Keep provider credentials in Claude.

<a id="phase-verify-access"></a>

### Verify access

<a id="step-review-the-claude-server"></a>

5. **Review the Claude server.** Run claude mcp list. Run claude mcp get tellagen to inspect its configuration.

Local configuration checks:

```shell
claude mcp list
claude mcp get tellagen
```

<a id="step-check-the-tools"></a>

6. **Check the tools.** In Tellagen, select Check MCP tools. Paste the prompt into Claude.

<a id="step-review-the-result"></a>

7. **Review the result.** Return to Tellagen. Make sure that required tool cards show INSTALLED and ACCESS OK.

## You are done when…

Claude Code can discover the Tellagen MCP server and its allowed incident tools.

## Troubleshooting

<a id="troubleshooting-claude-cannot-find-the-tellagen-mcp-server"></a>

### Claude cannot find the Tellagen MCP server.

Re-copy the Claude command from Local investigation tools and confirm the local MCP configuration was saved.

<a id="troubleshooting-the-tool-check-reports-a-missing-provider"></a>

### The tool check reports a missing provider.

Install the required provider MCP tool from the MCP tool gallery, add its local credential, and check again.

<a id="troubleshooting-claude-mcp-list-does-not-show-tellagen"></a>

### claude mcp list does not show Tellagen.

Run the copied claude mcp add command again. Then inspect it with claude mcp get tellagen. Existing incident work stays in Tellagen. If the server is still absent, ask the local client administrator to inspect the Claude configuration.

<a id="troubleshooting-tellagen-shows-access-denied"></a>

### Tellagen shows ACCESS denied.

Replace the local token with a Local Diagnosis key. Do not remove the saved investigation. If access still fails, ask a workspace manager to review the key scopes.

## Related articles

- **Recommended next task:** [Run a local Diagnosis for an incident](https://tellagen.com/help/run-local-diagnosis)
- [Configure MCP tools for Diagnosis](https://tellagen.com/help/configure-mcp-tools-for-diagnosis)
- [Manage API keys](https://tellagen.com/help/manage-api-keys)

## External setup references

- [Anthropic Claude Code MCP documentation](https://code.claude.com/docs/en/mcp) (verified 2026-08-29)


## Continue through the incident lifecycle

- **Previous task:** [Configure Codex for Tellagen Diagnosis](https://tellagen.com/help/configure-codex-for-diagnosis)
- **Next task:** [Configure MCP tools for Diagnosis](https://tellagen.com/help/configure-mcp-tools-for-diagnosis)
- [Back to Support Center](https://tellagen.com/help#help-search)

## Last verified date

2026-08-29