Selda

Selda MCP

AI クライアントを Selda のワークスペースに接続します。

他社が提供するのはツールです。Selda が構築するのは、営業活動を動かす仕組みです。アプローチする価値のあるタイミングを見つけ、企業ごとに調査を行い、顧客の言葉でメッセージを書き、あなた自身の受信トレイから送信し、返信をあなたに届けます。送信は毎回、人が承認します。このリポジトリは、アプリの外部から Model Context Protocol または通常の HTTP を介してこの仕組みを動かすための、機械可読なドキュメントです。

MCP と API は、無料プランを含むすべてのプランで利用できます。 クライアントを接続するために上位プランにする必要はありません。無料ワークスペースのキーでできることについては、キー、スコープ、分離をご覧ください。

説明文書は docs.selda.ai/reference/mcp にあります。両者の内容が異なる場合は、以下で説明する最新の機能マニフェストが正しい情報です。

できること

目的	方法
AI クライアントからワークスペース、リード、キャンペーン、スレッドを読み取る	ホステッドサーバーに接続して、あとは尋ねるだけです
すでに行った調査を Selda に渡し、その資料を基に文章を書かせる	analysis フィールドを指定して selda_add_lead を使うか、ファイルをアップロードしてインポートします
概要からパイプライン全体を実行し、生成された下書きを読む	selda_run_pipeline を実行し、その後 selda_get_run_status をポーリングします
ポーリングせず、返信が届いた時点で受け取る	reply.received の送信先 Webhook を登録します
問い合わせが届いたら、誰かが確認する前に返信する	autoAdvance を指定して selda_ingest_event を使い、その後 draft.ready を待ち受けます
メッセージに画像を載せる。リードごとに別の画像も指定できます	selda_add_lead／selda_add_leads／selda_ingest_event で mediaImageUrl を指定し、クリック可能にするには mediaLinkUrl も指定します
メッセージにファイルを添付する、またはキャンペーン内のすべてのメッセージにファイルを添付する	selda_upload_file を実行し、leadId または runId を指定して selda_attach_files を使います
試験的なインストールで残された行を削除する	selda_delete_lead を使うか、重複を解消するには selda_merge_leads を使います

意図的にできないこと

ここでできる操作では、営業メッセージは送信されません。 スクリプトで、メッセージの下書き作成までキャンペーンを進めることはできます。 送信ボタンを押すのは、Selda アプリ上の人です。キャンペーンのメッセージ送信を開始する関数はなく、それを無効にするフラグもありません。

これは今後解消する予定の制限ではありません。Selda の中核となる理念です。Selda が提案し、人が決定します。

接続

Claude.ai、ChatGPT、Cursor におすすめの OAuth

カスタムコネクターとして、以下を追加します。

https://mcp.selda.ai/api/mcp

サーバーは OAuth に対応しているため、クライアントの案内に従ってログインし、ワークスペースを選択できます。 貼り付けるものはありません。

Claude Code、スクリプト、CI 向けの静的キー

Selda アプリの Settings → Connections → MCP server でキーを作成します。キー全体が表示されるのは一度だけです。

claude mcp add --transport http selda https://mcp.selda.ai/api/mcp \
  --header "Authorization: Bearer $SELDA_API_KEY"

設定ファイルを読み込むほかの MCP クライアントでも、同じ URL とヘッダーを使えます。

キー、スコープ、分離

キーは sk_live_…（本番）または sk_test_…（サンドボックス）です。保存されるのは SHA-256 ハッシュのみのため、 キーを紛失した場合は復元できず、失効させる必要があります。

スコープ	許可される操作
read	読み取り操作
write	書き込み操作
pipeline	クレジットを消費するパイプラインおよびエンジンの操作

すべての呼び出しは、キーを所有する組織に紐づけられます。組織 ID は検証済みのキーからサーバー側で注入されるため、リクエスト本文の orgId は無視されます。ある組織のキーで別の組織のデータにアクセスすることはできません。

無料プランを含め、どのプランでも接続できます。 キーの作成に、プランや請求書による制限はありません。テストモードのワークスペースでは常に sk_test_ が発行され、本番利用が承認されたワークスペースでは常に sk_live_ が発行されます。プレフィックスが示すのは環境であり、それ自体に権限はありません。すべての制限は、保存された環境とワークスペースの本番利用権限を、リクエストごとに再確認して判定します。

そのため、無料のワークスペースでは、料金が発生する機能や実在の人物を特定する機能を除くすべての機能を利用できるテストキーが発行されます。これだけで、実際の処理を始める前に連携全体を構築できます。各キーで呼び出し可能な機能は、機能マニフェストで確認してください。

基盤となる HTTP API

MCP ツールは、直接呼び出すこともできる HTTP API の厳選されたフロントエンドです。

ベース URL は https://api.selda.ai です。

エンドポイント	メソッド	目的
/mcp/query	POST	読み取り
/mcp/mutate	POST	書き込み
/mcp/run	POST	パイプラインおよびエンジンの操作
/mcp/material/upload	POST	ファイルの生データを送信し、ストレージ ID を受け取る
/mcp/capabilities	GET	機能マニフェスト。キーは不要

これらのエンドポイントはすべて、同じハンドラーを指す /v1/ エイリアス（/v1/mcp/query、/v1/mcp/mutate、 /v1/mcp/run、/v1/mcp/material/upload、/v1/mcp/capabilities）でも応答します。バージョン指定なしのパスは今後も維持され、変更されることはありません。動作に変更が加わる場合は /v1/ に反映されるため、長期利用を前提とする場合はこちらを使用してください。

本文は常に { "fn": "...", "args": { ... } } です。成功時は { "value": … } が返され、失敗時は非 200 ステータスとともに { "error": { "type", "code", "message", "request_id" } } が返されます。

操作ごとの URL も用意されています。 クライアントが必要とする場合は、GET /v1/leads、 POST /v1/leads、POST /v1/runs/{runId}/confirm-companies など、60 を超えるエンドポイントを OpenAPI 3.1 のドキュメントとともに利用できます。ディスパッチャー、キーの確認、スコープの確認、拒否の動作は共通しているため、どちらの形式を使っても、もう一方で拒否される操作にアクセスすることはできません。この API は Selda-rest-api に記載されています。コードを書くときはこちらを、AI クライアントを接続するときはこのリポジトリを使用してください。

ベース URL と最新の関数一覧は、ハードコードせず、マニフェストから取得してください。これを約 40 行で実現するクライアントについては、examples/ を参照してください。

すでにある調査情報をもとにメッセージを作成する

見込み顧客ごとの調査は、おそらくすでに別の場所で行っているでしょう。情報を取り込む方法は 2 つあります。どちらも、一から情報を収集するのではなく、提供された資料をもとに Selda が文章を作成します。

すでに調査済みの企業が 1 社ある場合：

curl -X POST "$SELDA_API_BASE/mcp/mutate" \
  -H "Authorization: Bearer $SELDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fn":"leads.add","args":{
        "projectId":"<workspace id>",
        "company":"Filterit Oy",
        "email":"[email protected]",
        "analysis":"They run three production lines and posted about downtime in March..."
      }}'

企業ごとに 1 つのフォルダーを使ってファイルをまとめている場合： 各ファイルを X-Selda-Path ヘッダー付きでアップロードし、返されたストレージ ID をインポートします。パスの先頭のフォルダー名で Selda がファイルを企業に対応付けるため、boreo/filterit/analyysi.pdf は Filterit に紐づけられます。

資料をインポートすると、キャンペーンと企業リストが作成され、そこで処理は停止します。Selda に資料を提供することは、資料を読む許可を与えることであり、キャンペーンの実行を許可することではありません。autoAdvance 引数を使うと、スクリプトで次の段階を 1 つずつ許可できます。それでも、送信はできません。

リポジトリの内容

パス	内容
schemas/capabilities.json	稼働中のサービスから生成されるすべての関数
examples/	依存関係のない、最小限の動作するクライアント
skills/	AI クライアントが Selda をうまく使う方法を学ぶための、読み込み可能なスキル
CHANGELOG.md	ツールの仕様変更。これにより、連携が気づかないうちに壊れるのを防ぎます

schemas/capabilities.json は GET /mcp/capabilities から生成されます。このエンドポイント自体も、各エンドポイントが使用するものと同じディスパッチテーブルから導出されます。存在しない関数を記載したり、存在する関数を漏らしたりすることはありません。各エントリには、fn、エンドポイント、スコープ、1 行の概要、それをラップする MCP ツール、サンドボックスキーで呼び出せるかどうか、呼び出せない場合はその理由、必要な追加の権限が記載されています。

ファイルと稼働中のエンドポイントに食い違いがあれば、正しいのはエンドポイントであり、このリポジトリの情報が古くなっています。長期にわたって使う場合は、ご自身で取得してください。

サンドボックスキーでできること、できないこと

2026 年 8 月 30 日にマニフェストが公開した 72 個の関数のうち、65 個はサンドボックスキーで利用可能で、7 個は利用できませんでした。これらの数値は利用可能な機能が変わるたびに変動するため、この段落ではなく GET /mcp/capabilities で確認してください。マニフェストが正式な情報であり、この数値はある時点のものです。

境界線は「読み取り」と「書き込み」ではありません。サンドボックスキーでは、ワークスペース全体を読み取れるうえ、独自のデータを投入することもできます。独自に調査した見込み客の追加、Brain への書き込み、資料のアップロードとインポート、その資料を使った下書きの作成が可能です。これこそがテストモードで利用できる製品の全機能であり、料金を支払う前に、料金を払う価値のあるものを構築する方法です。

サンドボックスキーでできないのは、エンジンに新たな連絡先データを生成させること、または実在の人物に接触することです。

関数	料金が発生する理由
company.lookup	有料のデータプロバイダーを通じて実在の人物を特定します
leads.enrich、leads.enrichBatch	同じく、見込み客ごとに料金が発生します
engine.start	発見処理：ウェブ検索、クロール、見込み客ごとの費用
connectors.sync	外部ソースからデータを取得し、情報を補完します
runs.confirmCompanies	実行対象の企業リストを確定し、有料処理を開始します
runs.startFromLeads	追加した見込み客ごとにメッセージを書き込みます
material.import で autoAdvance を指定した場合	この権限付与により、実行処理が連絡先の検索に進みます

ここで問われるのは、どのプレフィックスを持っているかではなく、誰が費用を負担するかです。 すでにプランで API が有効になっており、請求額も支払い済みのワークスペースに属するサンドボックスキーであれば、上記のすべての項目を呼び出せます。その際の費用は、そのワークスペース自身のクレジットから支払われます。拒否の対象は、Selda の負担で Selda を連絡先データ API として利用する無料アカウントであり、サンドボックスで作業する有料顧客ではありません。material.import は、関数そのものではなく引数によって条件が決まる唯一の項目です。そのため、マニフェストでは sandboxAllowed: true と報告され、autoAdvance が渡された場合に限り拒否されます。

この表には、2026 年 8 月 20 日まで messages.send が記載されていました。ディスパッチテーブルにはそのような関数は存在せず、今後追加する予定もありません。有効なキーで利用できるのは、費用が発生するかデータプロバイダーに接続する上記の呼び出しであり、受信者に接触する呼び出しはありません。これを黙って削除するのではなく、ここで修正しているのは、すでにこの情報を読んで予定を立てた人がいる可能性があるためです。

拒否された呼び出しは、処理を分岐するための code と、人に見せられるメッセージを含む 403 を返します。ワークスペースの作成はどちらのリストにも含まれません。Selda アプリ内で行うものであり、どのキーからも呼び出せる関数はありません。

サポート

ご質問や、必要なツールが存在しない場合は、docs.selda.ai/support をご覧ください。

MIT ライセンスです。このリポジトリにはドキュメント、例、スキルが含まれています。Selda のソースコードは含まれていません。