cantrip

mcp-server-cantrip

Cantrip は、構造化された GTM ワークフローを通じて、技術系創業者が最初の顧客を見つけるのを支援します。

• ICP を明確にする — 理想的な顧客プロファイル、購買者の課題、価値提案を定義します
• 競合を調査する — 市場の全体像を把握し、勝てる領域を見つけます
• 次のアクションを得る — ギャップ分析で取り組むべきことを具体的に把握し、その作業も実行します

Claude Code ／ Claude Desktop ／ Cursor — MCP 互換のエージェントであれば、どれでも使用できます。

クイックスタート

1. cantrip.ai（設定）で API キーを取得します
2. サーバーを追加します：

claude mcp add cantrip -e CANTRIP_API_KEY=your-api-key -- npx -y mcp-server-cantrip

3. 次のプロンプトを試します：

「自分の製品について、Cantrip プロジェクトを初期化してください：[製品を一文で説明]」

設定

上記のクイックスタートコマンドは Claude Code に対応しています。claude mcp list またはセッション内の /mcp コマンドで、正常に動作したことを確認してください。

Claude Desktop ／ Cursor ／ 手動での JSON 設定

すべての MCP クライアントで同じ JSON ブロックを使用します。適切な設定ファイルに追加してください：

クライアント	設定ファイル
Claude Code（手動）	~/.claude.json
Claude Code（プロジェクト単位）	プロジェクトのルートにある .mcp.json
Claude Desktop（macOS）	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop（Windows）	%APPDATA%\Claude\claude_desktop_config.json
Cursor	.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）

{
  "mcpServers": {
    "cantrip": {
      "command": "npx",
      "args": ["-y", "mcp-server-cantrip"],
      "env": {
        "CANTRIP_API_KEY": "your-api-key"
      }
    }
  }
}

注： -y フラグは必須です。指定しないと npx が確認を求め、stdio 上で処理が停止します。

Windows（WSL 以外）： "command": "cmd" と "args": ["/c", "npx", "-y", "mcp-server-cantrip"] を使用してください。

チームでプロジェクト単位の設定を使用する場合： env の値に "${CANTRIP_API_KEY}" を指定すると、各開発者がシェルプロファイルでキーを設定できます。

プロジェクトコンテキスト（.cantrip.json）

各プロジェクトディレクトリには、Cantrip の操作対象プロジェクトを指定する .cantrip.json ファイルがあります：

{
  "project": "my-saas"
}

このファイルは cantrip_init（新規プロジェクト）または cantrip_connect（既存プロジェクト）によって自動的に作成されます。エージェントが管理するため、手動で作成する必要はありません。

同じマシンで複数のプロジェクトを扱っていますか？ 各プロジェクトディレクトリに、それぞれ独自の .cantrip.json が作成されます。エージェントは、適切なディレクトリで作業することでコンテキストを切り替えます。

Cantrip の使用例

Cantrip に接続したら、次のプロンプトを順番に試してください：

1. 「自分の製品について、Cantrip プロジェクトを初期化してください：[開発中のものを一文で説明]」
2. 「自分に合いそうな ICP と、購買者の主な課題を 3 つ見つけてください。」
3. 「競合を 5 社調査し、どこで勝てるか教えてください。」
4. 「1 週間分の GTM 計画を作成してください。」

トラブルシューティング

サーバーが見つからない／ツールが表示されない：

• claude mcp list（Claude Code）またはセッション内の /mcp を実行して、接続状態を確認してください。
• 設定が正しいファイルにあることを確認してください。Claude Code が使用するのは ~/.claude.json または .mcp.json であり、~/.claude/mcp.json ではありません。

サーバーの起動時に停止する：

• npx の引数に -y があることを確認してください。指定しないと、npx は対話型の確認を待ち続けますが、stdio 経由では確認に応答できません。

「Cantrip API に接続できません」というエラー：

• MCP 設定の env ブロックで CANTRIP_API_KEY が設定されていることを確認してください。
• ネットワークから https://api.cantrip.ai に接続できることを確認してください。

Windows で「Connection closed」エラーが発生する：

• "command": "cmd" と "args": ["/c", "npx", "-y", "mcp-server-cantrip"] を使用してください。

アーキテクチャ

Agent (Claude, etc.) ── MCP protocol (stdio) ──> mcp-server-cantrip ── HTTPS POST ──> https://api.cantrip.ai

MCP サーバーは薄い変換レイヤーです。MCP ツールの呼び出しを {command, args, flags} の JSON エンベロープに変換し、Cantrip API に POST します。ビジネスロジックは一切なく、CLI および React UI と同一の契約を使用します。

ツール（17）

セットアップ

ツール	説明
cantrip_connect	ワークスペースをプロジェクトに接続します（.cantrip.json を読み書きします）
cantrip_status	デーモンが実行中か確認します
cantrip_init	新しいプロジェクトを作成して自動的に接続します

コアコマンド

ツール	説明
cantrip_snapshot	プロジェクトの概要を表示し、エンティティタイプを詳しく確認します
cantrip_next	ギャップ分析の機会を一覧表示します
cantrip_next_prompt	機会に関するコンテキストが豊富な LLM プロンプトを生成します
cantrip_next_run	機会に取り組むバックグラウンドエージェントを起動します
cantrip_history	監査証跡を照会します

レビュー

ツール	説明
cantrip_review	レビュー待ちの項目を一覧表示します
cantrip_review_accept	推論されたエンティティを承認します
cantrip_review_reject	推論されたエンティティを却下します
cantrip_review_resolve	エスカレーションを解決します
cantrip_review_dismiss	エスカレーションを却下します

エンティティの CRUD（汎用）

ツール	説明
cantrip_entity_list	指定したタイプのエンティティを一覧表示します
cantrip_entity_show	エンティティの詳細を表示します
cantrip_entity_add	新しいエンティティを作成します
cantrip_entity_edit	既存のエンティティを編集します

対応するエンティティタイプ：icp、pain_point、value_prop、experiment、channel、competitor、contact

ライセンス

MIT