> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telemetron.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP (Claude Code)

> Connect Telemetron as an MCP server for Claude Code

## Overview

Model Context Protocol (MCP) lets Claude Code access your Telemetron support tools directly from the terminal. Once connected, Claude Code can query support cases, look up customer information, check device status, and use any other tools configured in your Telemetron organization — all without leaving your development environment.

## Prerequisites

* [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated
* A Telemetron API key (found in **Settings > Integrations**)

## Setup

<Steps>
  <Step title="Add the MCP Server">
    Run the following command in your terminal to register Telemetron as an MCP server:

    ```bash theme={null}
    claude mcp add telemetron \
      --transport http \
      https://admin.telemetron.ai/api/mcp \
      --header "Authorization: Bearer YOUR_API_KEY"
    ```

    Replace `YOUR_API_KEY` with your API key from **Settings > Integrations** in the Telemetron dashboard.
  </Step>

  <Step title="Verify the Connection">
    Start a new Claude Code session and ask it to list available tools. You should see your Telemetron organization's support tools available alongside Claude Code's built-in tools.
  </Step>
</Steps>

## Configuration

No additional configuration is required. The MCP server automatically exposes all tools configured in your Telemetron organization.

To update or remove the MCP server:

```bash theme={null}
# Update the API key
claude mcp remove telemetron
claude mcp add telemetron \
  --transport http \
  https://admin.telemetron.ai/api/mcp \
  --header "Authorization: Bearer NEW_API_KEY"

# Remove the server entirely
claude mcp remove telemetron
```

## How It Works

Claude Code communicates with the Telemetron MCP server over HTTP, authenticated with your API key. The server exposes your organization's support tools — including case lookup, customer search, device queries, and any custom API tools you have configured. Claude Code can call these tools during conversations, bringing your support data directly into your development workflow.

## Troubleshooting

| Issue                     | Resolution                                                                                                          |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Tools not appearing**   | Verify the API key is valid and has not been regenerated. Re-run the `claude mcp add` command with the current key. |
| **Authentication errors** | Ensure the `Authorization` header includes the `Bearer` prefix followed by a space and your API key.                |
| **Connection refused**    | Check your network connection. Ensure `https://admin.telemetron.ai` is reachable from your machine.                 |
| **Stale data**            | The MCP server queries Telemetron in real time. If data seems outdated, verify it in the Telemetron dashboard.      |