Kylas

Kylas CRM MCP サーバー（リードのみ）

Kylas CRM のリード操作に対応する Model Context Protocol サーバーです。Cursor、Claude Desktop、または任意の MCP クライアントから使用して、リードの作成、検索と絞り込み、ユーザー、製品、パイプラインの参照を行えます。

機能

• get_lead_field_instructions – リードのスキーマ（標準フィールドとカスタムフィールド、選択リスト ID）を取得します
• create_lead – ユーザーコンテキストから動的にフィールドを設定してリードを作成します
• search_leads – 複数の条件でリードを検索・絞り込みます
• lookup_users – ユーザー名を ID に解決します（担当者、作成者など）
• lookup_products – 製品名を ID に解決します
• lookup_pipelines / get_pipeline_stages – 未完了／クローズ済み／成約済みのリードに対応するパイプラインとステージを解決します
• search_idle_leads – N 日間アクティビティのないリードを検索します

必要条件

• Python 3.10+
• Kylas アカウントと API キー

インストール

pip install -e .
# or from PyPI (after publish): pip install kylas-crm-mcp-server

設定

環境変数を設定します（または .env ファイルを使用します）。

変数	必須	説明
KYLAS_API_KEY	はい	Kylas API キー
KYLAS_BASE_URL	いいえ	API のベース URL（デフォルト：https://api.kylas.io/v1）

サーバーの実行

このサーバーはstdioトランスポート（MCP のデフォルト）を使用します。次のコマンドを実行します。

python -m kylas_crm_mcp
# or: python main.py  (when developing from repo root)

MCP クライアント（例：Cursor）は通常、このプロセスを起動し、stdin/stdout 経由で通信します。

Docker

docker build -t kylas-crm-mcp .
docker run -e KYLAS_API_KEY=your_key -i kylas-crm-mcp

開発

pip install -e ".[dev]"
pytest

MCP Marketplace への公開

このサーバーを公式 MCP Registryに公開するには（Cursor やその他の MCP クライアントに表示されるようにするには）：

1. パッケージを PyPI に公開します（レジストリは README を使って所有権を確認します）。
2. mcp-publisher をインストールし、mcp-publisher login github を実行してから、mcp-publisher publish を実行します。

詳しい手順については PUBLISHING.md をご覧ください。

ライセンス

ライセンス情報については、リポジトリをご覧ください。