MCP Pickaxe

🚀 MCP Pickaxe Server

このサーバーは、ClaudeなどのAIアシスタントをPickaxeプラットフォームに接続するMCP（Model Context Protocol）サーバーです。自然言語で直接AIエージェント、知識ベース、ユーザー、分析を管理できます。

🚀 クイックスタート

このMCPサーバーを使用することで、Pickaxe上でAIエージェントを構築する際に以下のことが可能になります。

• エージェントの会話分析 - チャット履歴をレビューして知識のギャップを特定し、エージェントのパフォーマンスを向上させます。
• 知識ベースの管理 - AIワークフローから離れることなく、文書を作成、更新し、エージェントに接続します。
• ユーザー管理 - ユーザーを作成、アクセスを管理、招待を送信、使用状況を追跡します。
• 複数のスタジオでの作業 - 単一のセッションで異なるPickaxeスタジオ間をシームレスに切り替えます。
• ワークフローの自動化 - Claudeに繰り返しのPickaxe管理タスクを処理させます。

✨ 主な機能

📦 インストール

オプション1: npmからインストール（推奨）

npx mcp-pickaxe

またはグローバルにインストールする場合は、以下のコマンドを実行します。

npm install -g mcp-pickaxe

オプション2: クローンしてビルド

git clone https://github.com/aplaceforallmystuff/mcp-pickaxe.git
cd mcp-pickaxe
npm install
npm run build

📚 ドキュメント

1. Pickaxe APIキーの取得

1. Pickaxe Studioにログインします。
2. 設定 > APIに移動します。
3. あなたのスタジオAPIキー（studio-で始まる）をコピーします。

2. MCPクライアントの設定

Claude Desktopの場合

Claude Desktopの設定ファイルに以下を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pickaxe": {
      "command": "node",
      "args": ["/path/to/mcp-pickaxe/dist/index.js"],
      "env": {
        "PICKAXE_STUDIO_MAIN": "studio-your-api-key-here"
      }
    }
  }
}

Claude Codeの場合

~/.claude.jsonに以下を追加します。

{
  "mcpServers": {
    "pickaxe": {
      "command": "node",
      "args": ["/path/to/mcp-pickaxe/dist/index.js"],
      "env": {
        "PICKAXE_STUDIO_MAIN": "studio-your-api-key-here"
      }
    }
  }
}

マルチスタジオ設定

複数のPickaxeスタジオで作業する場合は、複数の環境変数を追加します。

{
  "env": {
    "PICKAXE_STUDIO_PRODUCTION": "studio-xxx-xxx-xxx",
    "PICKAXE_STUDIO_STAGING": "studio-yyy-yyy-yyy",
    "PICKAXE_STUDIO_DEV": "studio-zzz-zzz-zzz",
    "PICKAXE_DEFAULT_STUDIO": "PRODUCTION"
  }
}

そして、リクエストで使用するスタジオを指定します。

• PICKAXE_DEFAULT_STUDIOを設定した場合、指定されない場合はそのスタジオが使用されます。
• 1つのスタジオのみが設定されている場合、自動的にそれが使用されます。
• それ以外の場合は、studio="STAGING"（または同様のもの）を任意のツールに渡します。

💻 使用例

基本的な使用法

設定が完了したら、自然言語でPickaxeと対話できます。

# エージェントのパフォーマンスを分析する
> "Show me the last 20 conversations from my support agent"
> "What questions are users asking that my agent can't answer?"

# 知識ベースを管理する
> "Create a new document called 'FAQ' with this content: [your content]"
> "Connect the FAQ document to my customer support agent"
> "List all documents in my knowledge base"

# ユーザー管理
> "Show me all users and their usage stats"
> "Create a new user with email user@example.com and give them access to the Pro product"
> "Send invitations to these emails: [list of emails]"

# マルチスタジオ操作
> "List all users in my staging studio"
> "Compare the documents between production and staging"

高度な使用法

以下は、利用可能なツールを使用した具体的な操作例です。

スタジオ管理

• studios_list - すべての設定されたスタジオと現在のデフォルトをリストします。

チャット履歴

• chat_history - エージェントの会話履歴を取得します。
  • パラメータ: pickaxeId, skip, limit, format ("messages" または "raw"), studio

文書管理

• doc_create - コンテンツまたはURLから文書を作成します。
• doc_list - すべての文書を（ページネーション付きで）リストします。
• doc_get - 特定の文書を取得します。
• doc_delete - 文書を削除します。
• doc_connect - 文書をエージェントにリンクします。
• doc_disconnect - 文書をエージェントからリンク解除します。

ユーザー管理

• user_list - アクセスと使用情報を含むすべてのユーザーをリストします。
• user_get - メールアドレスで特定のユーザーを取得します。
• user_create - 新しいユーザーを作成します。
• user_update - ユーザーの詳細、製品、または使用状況を更新します。
• user_delete - ユーザーを削除します。
• user_invite - メール招待を送信します。

製品

• products_list - 利用可能な製品/バンドルをリストします。

メモリ

• memory_list - メモリスキーマをリストします。
• memory_get_user - ユーザーの収集されたメモリを取得します。

🔧 開発

# 開発モードで実行（自動リロード）
npm run dev

# 本番用にビルド
npm run build

# ビルドされたバージョンを実行
npm start

トラブルシューティング

"No Pickaxe studios configured"

MCP設定で少なくとも1つのPICKAXE_STUDIO_*環境変数が設定されていることを確認してください。

"Studio not found"

スタジオ名が正確に一致することを確認してください（大文字と小文字は区別されません）。studios_listを実行して利用可能なオプションを確認します。

"Pickaxe API error (401)"

あなたのAPIキーが無効または期限切れです。Pickaxe Studioの設定から新しいキーを取得してください。

"Pickaxe API error (403)"

あなたのAPIキーにこの操作の権限がありません。Pickaxeアカウントの権限を確認してください。

コントリビューション

コントリビューションは大歓迎です！詳細なガイドラインについては、CONTRIBUTING.mdを参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSEを参照してください。

リンク

• Pickaxe Platform
• Pickaxe Studio
• Model Context Protocol
• MCP Specification