Zelinqa MCP

インストール · 使用例 · ツール · 設定 · 運用 · Français

会話を進めるのはアシスタントです。次に何を尋ねるかを決めるのは Zelinqa です。 会話で何を明らかにする必要があるかを、Zelinqa Studio で一度説明してください。このサーバーは、あらゆる MCP ホストがその会話を進めるためのツールを提供します。会話を開始し、各回答を渡し、次の質問を取得し、結果を記録できます。モデルに表示されるのは、質問文、選択肢のラベル、会話名だけです。セッション、判断、状態の識別子はサーバー内にとどまります。

トークンを削減し、決定論的で、説明可能

エンジンが質問を選ぶため、モデルは質問を生成したり、同じ質問を繰り返したりしなくなり、同じ対話で使用するトークンが減ります。選択は、公開済みドメインから選ぶものであり、生成ではありません。同じ状態なら常に同じ質問が返され、各判断には、質問が収集する情報、各次元の進捗、明示的な停止理由が含まれるため、会話を後から監査できます。トークン数の測定値は、2026年9月の内部テストベンチに基づいています。同じアシスタントを使って700件を超える会話を2回再生し、一方は単独で、もう一方は Zelinqa エンジンの制御下で実行しました。シミュレーションした回答者は、両方で同一の内容を再生しました。プロトコル、測定値、制限については、テストベンチのレポートをお読みください。共有データとコードを用いた科学的ベンチマークは、2026年末までに公開する予定です。

理由

面接、資格判定、案内、トリアージ、推薦など、判断の前に質問をする必要があるアシスタントは、質問を即興で作り、情報に抜けがある状態で判断してしまいます。このサーバーでは、エンジンが公開済みのドメインに基づいて質問フェーズを実行し、モデルは型付きの完全な状態をもとに一度だけ判断します。

インストール

uv を使用する Python 3.11 以降と、Zelinqa Studio で作成した公開済みドメイン用の ランタイム API キー が必要です。無料の Developer エディション アカウントで十分です。

または、サーバーをホストに手動で追加します。コマンドはどの環境でも同じです。uvx zelinqa-mcp を実行し、キーはホストのシークレット環境に設定します。

claude mcp add zelinqa \
  -e ZELINQA_API_KEY=YOUR_RUNTIME_API_KEY \
  -- uvx zelinqa-mcp

{
  "mcpServers": {
    "zelinqa": {
      "command": "uvx",
      "args": ["zelinqa-mcp"],
      "env": {
        "ZELINQA_API_KEY": "YOUR_RUNTIME_API_KEY"
      }
    }
  }
}

[mcp_servers.zelinqa]
command = "uvx"
args = ["zelinqa-mcp"]
env = { ZELINQA_API_KEY = "YOUR_RUNTIME_API_KEY" }

git clone https://github.com/Zelinqa/zelinqa-mcp.git
cd zelinqa-mcp
uv sync --group dev --locked
uv run zelinqa-mcp --version

各ホスト向けのコピーしてすぐ使えるファイルは examples/ にあります。ホストのツール承認ポリシーはそのまま維持してください。一部の呼び出しでは、セッションやフィードバックが作成されます。

4 回のツール呼び出しで進む会話

モデルは zelinqa_start を呼び出し、返された質問を自分の言葉で尋ね、相手の回答を zelinqa_next_question に渡します。エンジンが停止するまでこれを繰り返し、最後に実際に起きたことを記録します。

▶ zelinqa_start           {"conversation": "lead-42"}
◀ ask  ·  "Which budget range are you considering this year?"
          choices: Under €10k · €10k to €50k · Over €50k

▶ zelinqa_next_question   {"conversation": "lead-42", "choice_labels": ["€10k to €50k"]}
◀ ask  ·  "When would you like to start?"
          progress: budget covered · timeline not started

▶ zelinqa_next_question   {"conversation": "lead-42", "user_text": "Next quarter, after the sales kickoff."}
◀ stop ·  objective achieved

▶ zelinqa_feedback        {"conversation": "lead-42", "result": "success"}

回答を渡さずに zelinqa_next_question を呼び出すと、保留中の質問が再表示されます。CRM がすでに回答を把握している場合は、質問せずに zelinqa_adjust で記録できます。zelinqa_adjust と zelinqa_add_context は、質問した情報がすでに判明している場合などに、保留中の質問を差し替えることがあります。返された質問は必ず尋ねてください。回答のルール全体については、docs/operations.md を参照してください。

ツール

結果には、質問文、順位、選択肢のラベル、目標の進捗状況、カウンターが含まれます。次の判断に関する結果には、警告、停止理由、縮退モードの理由も含まれます。max_turns に達すると、結果は action: "stop" および stop_reason: "max_turns_reached" となり、それ以降の呼び出しでも同じ停止結果が返されます。ターン制限に達したことは、目標が達成された証拠ではありません。

zelinqa-mcp --advanced はビジネスツールを、API 識別子と完全な状態を公開する6つの低レベルツールに置き換えます。docs/operations.md を参照してください。

設定

セキュリティと状態

• トランスポートは stdio で、信頼されたホストとユーザーごとにプロセスを1つ分離して実行します。認証とセッション分離が実装されるまでは、HTTP ホスティングは無効です。ログは stderr に出力され、stdout は MCP 専用です。
• サーバーはメモリ上で最大128個の名前付き会話を保持し、通知なく削除することはありません。名前はプロセス内でのみ有効です。再起動後も維持するには、ホストが API セッション ID を保持し、モデルの外部で上記の再開用変数を設定します。
• 同じ会話を変更する呼び出しは逐次実行する必要があります。同時に呼び出すと、古い状態に基づいて応答するのではなく、呼び出しが拒否されます。競合後は zelinqa_status を呼び出し、再度回答する前に状態を確認して調整してください。

詳細、再試行の動作、テストスイートについては docs/operations.md を参照してください。脆弱性の報告先は SECURITY.md です。

関連項目

• zelinqa-sdk：このサーバーの基盤となる Python および TypeScript のクライアントです。API を直接呼び出すアプリケーション向けです。
• docs.zelinqa.ai：概念、Studio ガイド、API リファレンスを掲載しています。

ライセンス

Apache-2.0。リリース手順については RELEASING.md を参照してください。