Installation

Get TachiBot MCP running in minutes. Install via npm and configure your API keys.

Install via npm

Add to Claude Desktop

Edit your Claude Desktop configuration file:

Add TachiBot to the MCP servers:

claude_desktop_config.json

Configure API Keys

There are two ways to configure API keys (pick one):

Option 1: User Config File (Recommended)

Create ~/.tachibot/.env with your API keys:

Option 2: Claude Code MCP Config

Add API keys directly in your Claude Code settings (~/.claude.json):

~/.claude.json

Config Priority

When the same key is set in multiple places, this is the priority order (highest wins):

Claude Code MCP config (~/.claude.json env)
User config (~/.tachibot/.env)
Project .env (development only)

🚀

NEW: Gateway Mode (v2.1.0)

Simplify setup with one API key! Enable Gateway Mode to route GPT-5.1, Gemini, and Grok through OpenRouter.

.env (Gateway Mode)

💡 Tip

You don't need all API keys! Only add keys for the tools you want to use. Check the Tools page to see which tools require which keys.

Verify Installation

Restart your Claude application (Claude Desktop or Claude Code) and check that:

TachiBot appears in the MCP servers list
Tools like mcp__tachibot-mcp__focus are available
No connection errors appear in the logs

💡 Claude Code vs Claude Desktop

TachiBot works with both Claude Code (CLI with file system access) and Claude Desktop (GUI chat interface).

Claude Code: Full MCP support with file operations, terminal access, and all TachiBot tools
Claude Desktop: MCP support with TachiBot reasoning and research tools (limited file access)

Next Steps

You're all set! Here's what to do next

Quick Start Guide

Run your first workflow

Configure Tools

Control token usage

Learn Workflows

Build custom multi-step processes