mcpField
A
Acme CRM example

Acme CRM example

ローカル
github.com開発ツール05 日前に更新
リポジトリ公式サイト

Acme CRM example について

Acme CRM exampleは、サードパーティ製ツールをWireCatに接続する方法を示す、WireCat互換のコマンドラインツールです。架空のCRMの合成データを使うため、実際のCRM管理ではなく連携例を目的としています。

主な機能

  1. 01OSのキーチェーンにトークンを保存してサインイン
  2. 02組織、人物、取引、請求書提案を同期
  3. 03取引と連絡先の一覧表示と詳細確認
  4. 04WireCat Desktop用マニフェストを提供
  5. 05MCPサーバーとエージェントスキルを同梱

活用シーン

  1. 01コミュニティ製CLIのWireCat連携を確認
  2. 02合成データでCRM同期フローを試す
  3. 03エージェントのコマンドで取引や連絡先を確認

MCP 対応

CLIにはMCPサーバーが含まれ、MCP設定をJSONで出力するコマンドもあります。エージェントから同期やCRMの読み取りコマンドを実行できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "leemour-acme-crm-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@leemour/acme-crm-cli"
      ]
    }
  }
}
起動コマンドnpx -y @leemour/acme-crm-cli

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@leemour/acme-crm-cli0.3.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

acme-crm

@leemour/acme-crm-cli は、WireCatLabs の外部で構築された、WireCat 互換 CLI のサンプルです。存在しないサービスである Acme CRM と通信します。ACME_CRM_BASE_URL が設定されていない場合、CLI は組み込みのフェイクから応答します。このフェイクには合成データのみが含まれています（組織 10 件、人物 25 件、取引 15 件、請求書 8 件）。名前はすべて架空で、住所はすべて example.com のものです。実際の CRM を管理するためではなく、サードパーティ製ツールが WireCat にどのように接続されるかを確認するためにお使いください。

実際のツールに必要な要素を示しています。

  • session start でサインインし、トークンを OS のキーリングに保存します。
  • sync は、cli-core の CRM ポートを介して組織、人物、取引をコピーし、records エンベロープを介して請求書をインポートします。インポートされた請求書は invoice: 提案として登録され、オーナーが WireCat で確認します。
  • 効果を宣言し、JSON を出力する読み取りコマンド：deals list、deals show、contacts list、contacts show
  • WireCat Desktop が読み込むマニフェスト contracts/wirecat.json、MCP サーバー、エージェントスキル

インストール

WireCat Desktop は、オーナーが有効にすると、@leemour/acme-crm-cli のようにまだ検証していないコミュニティ製ツールを取り込む予定です。その際、パッケージの来歴レコードを検証します。このレコードが付与されるのは、release.yml で公開されたバージョンのみです。それまでは、ターミナルからインストールしてください。

npm install -g @leemour/acme-crm-cli

プロファイルにサインインします。フェイクでは acme_test_ で始まるトークンなら何でも使えます（例：acme_test_demo）。

acme-crm personal session start
acme-crm personal sync
acme-crm personal deals list status:open

アカウントを使用するすべてのコマンドでは、プロファイルを指定します（上記の personal など）。ツールがプロファイルを自動で選ぶことはありません。

エージェントでの使用

acme-crm skill install --for claude
acme-crm personal mcp config --json

エージェントは、たとえば次のように実行します。

acme-crm personal sync --json
acme-crm personal deals list status:won --json=ref,title,amount,currency
acme-crm personal contacts show per_01 --json

開発

pnpm install
pnpm test
pnpm generate

設計については docs/dev/DESIGN.md を参照してください。bin/first-publish は最初のバージョンを手動で公開します。それ以降のバージョンは、npm の信頼された公開を使って .github/workflows/release.yml から公開します。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。