Skip to main content

Installing think-tool

This guide walks you through installing and configuring the think-tool MCP server.

Prerequisites​

  • Claude Code installed and working
  • Node.js 18.0 or higher
  • Active Claudefast subscription
Get think-tool License

Installation Methods​

Global Installation​

Install think-tool globally for use across all projects:

# Install globally
npm install -g @claudefast/think-tool

# Verify installation
think-tool --version

Register with Claude​

# Add to Claude's MCP servers
claude mcp add think-tool npx @claudefast/think-tool

# Restart Claude to load the server
claude restart

Configuration​

Basic Configuration​

Create ~/.think-tool/config.json:

{
  "license": "YOUR_LICENSE_KEY",
  "reflection": {
    "autoTrigger": true,
    "verbosity": "normal",
    "saveHistory": true
  }
}

Advanced Configuration​

{
  "license": "YOUR_LICENSE_KEY",
  "reflection": {
    "autoTrigger": true,
    "verbosity": "detailed",
    "saveHistory": true,
    "historyPath": "~/.think-tool/history",
    "triggers": {
      "commands": ["bash", "edit", "write"],
      "keywords": ["deploy", "delete", "production"],
      "complexity": 8
    },
    "export": {
      "format": "markdown",
      "includeTimestamps": true
    }
  },
  "server": {
    "port": 3461,
    "host": "localhost"
  }
}

Verification​

Check Installation​

# List Claude's MCP servers
claude mcp list

# Should show:
# - think-tool (local) ✓

Test Reflection​

You: Test think-tool reflection

Claude: [REFLECTION] Testing think-tool integration:
- Server status: Connected ✓
- License: Valid ✓
- Auto-trigger: Enabled ✓
- History: Recording ✓

Think-tool is working correctly!

Environment Setup​

For Teams​

Share configuration across team:

# .env
THINK_TOOL_LICENSE=team-license-key
THINK_TOOL_HISTORY_PATH=/shared/reflections
THINK_TOOL_VERBOSITY=detailed

For CI/CD​

Configure for automated environments:

# .github/workflows/ci.yml
env:
  THINK_TOOL_LICENSE: ${{ secrets.THINK_TOOL_LICENSE }}
  THINK_TOOL_AUTO_TRIGGER: true
  THINK_TOOL_EXPORT_FORMAT: json

IDE Integration​

VS Code​

Add to workspace settings:

{
  "claude.mcp.servers": {
    "think-tool": {
      "enabled": true,
      "showInline": true
    }
  }
}

JetBrains​

Configure in project settings:

  1. Open Settings → Tools → Claude Code
  2. Add MCP Server → think-tool
  3. Enable "Show reflections inline"

Troubleshooting​

Server Not Found​

# Check if think-tool is in PATH
which think-tool

# If not found, add to PATH
export PATH="$PATH:$(npm bin -g)"

Connection Failed​

# Check server status
think-tool status

# Restart server
claude mcp restart think-tool

# Check logs
think-tool logs --tail 50

License Issues​

# Verify license
think-tool license verify

# Update license
think-tool license update YOUR_NEW_KEY

Performance Issues​

If reflections are slow:

  1. Check verbosity setting (use "normal" instead of "detailed")
  2. Disable history if not needed
  3. Increase server resources in Docker

Security Considerations​

License Key Protection​

Never commit license keys:

# .gitignore
.think-tool/config.json
.env

Network Security​

For remote teams:

{
  "server": {
    "host": "0.0.0.0",
    "port": 3461,
    "ssl": {
      "enabled": true,
      "cert": "/path/to/cert.pem",
      "key": "/path/to/key.pem"
    }
  }
}

Updating​

Check for Updates​

# Check current version
think-tool --version

# Check for updates
npm outdated -g @claudefast/think-tool

# Update to latest
npm update -g @claudefast/think-tool

Migration Guide​

When updating major versions:

# Backup current config
think-tool backup

# Update
npm update -g @claudefast/think-tool

# Run migration
think-tool migrate

# Verify
think-tool verify

Uninstallation​

If you need to remove think-tool:

# Remove from Claude
claude mcp remove think-tool

# Uninstall package
npm uninstall -g @claudefast/think-tool

# Clean up config (optional)
rm -rf ~/.think-tool

Next Steps​