Claude Code

Connect Corsair to Claude Code via MCP or use the CLI directly.

MCP

Use runStdioMcpServer to expose Corsair as a local MCP server that Claude Code spawns on demand.

Install

npm install @corsair-dev/mcp

Create the server script

mcp-server.ts

import 'dotenv/config';
import { runStdioMcpServer } from '@corsair-dev/mcp';
import { corsair } from './corsair';

runStdioMcpServer({ corsair }).catch((err) => {
    console.error('[corsair-mcp] Fatal:', err);
    process.exit(1);
});

Configure Claude Code

Add a .mcp.json file at your project root. Claude Code reads this automatically when you open the project.

.mcp.json

{
  "mcpServers": {
    "corsair": {
      "command": "npx",
      "args": ["tsx", "mcp-server.ts"]
    }
  }
}

If your credentials aren’t loaded from a .env file, pass them via env:

.mcp.json

{
  "mcpServers": {
    "corsair": {
      "command": "npx",
      "args": ["tsx", "mcp-server.ts"],
      "env": {
        "CORSAIR_KEK": "your-key-here"
      }
    }
  }
}

Restart Claude Code after adding the config. You can verify the server is connected by running /mcp in the Claude Code prompt. corsair should appear in the list.

Usage

Once connected, Claude Code can call Corsair tools directly. Start a conversation:

Setup corsair, then list all Slack channels.

Claude calls list_operations to discover available endpoints, get_schema to inspect parameters, then run_script to execute.

CLI

npm

npm install @corsair-dev/cli

Copy and paste this prompt into Claude Code to give it everything it needs to work with Corsair:

Run `pnpm corsair` to access Corsair's integrations.