Dactic

Dactic MCP

ホスト型サービス https://mcp.app.dactic.io/mcp を通じて、MCP クライアントを Dactic の作業コンテキストに接続します。Dactic アカウントと、要求する機能へのアクセス権が必要です。利用できるツールは、アカウントと権限によって異なります。

このリポジトリには、公開クライアントマニフェスト、インストールガイド、および stdio ランチャーの完全なソースコードが含まれています。ランチャーでは、バージョンが固定された mcp-remote トランスポートと OAuth 実装を使用します。バックエンドの処理は引き続き、ホスト型の Dactic サービス上で行われます。レビュー担当者とユーザーは同じインテグレーションを使用します。

ドラフトリリース： npm のインストール例は、@dactic/[email protected] の公開後に掲載する予定です。現時点ではローカルのチェックアウトを使用してください。マーケットプレイスの承認と、本番環境での認証済み検証については、リリースチェックリストで管理しています。

直接接続する（推奨）

クライアントの MCP 設定に、URL https://mcp.app.dactic.io/mcp の Streamable HTTP MCP サーバーを追加し、クライアントの OAuth サインインと同意のフローを完了します。このリポジトリに API キーは埋め込まれていません。

Cursor の場合は、次のエントリーを既存の MCP 設定にマージします。

{"mcpServers":{"dactic":{"url":"https://mcp.app.dactic.io/mcp"}}}

Claude Code の場合は、同梱の .mcp.json を使用するか、次を実行します。

claude mcp add --transport http dactic https://mcp.app.dactic.io/mcp

このリポジトリには、Cursor、Claude、およびポータブルプラグインのマニフェストも含まれています。Claude プラグインをローカルで確認するには claude plugin validate . を実行します。ローカルセッションを開始するには claude --plugin-dir /absolute/path/to/dactic-v1-mcp-public を実行します。マーケットプレイス形式については、クライアントのインストールを参照してください。

stdio 経由で接続する

Node.js 22.12 以降をインストールします。チェックアウトしたディレクトリから、次を実行します。

npm ci
npm run verify
node src/cli.js --help

examples/stdio.local.json をホストの設定にマージし、絶対パスをチェックアウトしたディレクトリのパスに置き換えます。stdin/stdout の接続を維持するため、MCP ホストから起動してください。OAuth の同意が必要な場合、ブリッジによってブラウザーが開きます。クライアントの JSON にアカウント認証情報を入力しないでください。

npm リリース後は、examples/stdio.npm.json を使用すると、npx -y @dactic/[email protected] で同じブリッジを実行できます。

ヘッドレス環境と Docker

アカウントで Dactic のベアラー認証情報がサポートされている場合は、DACTIC_MCP_TOKEN 環境変数で指定してください。値はホストのシークレット設定またはプライベート環境に設定し、コミットしないでください。ブリッジは、プロセス引数に認証情報を含めず、リテラルな環境変数プレースホルダーを子プロセスに渡します。OAuth とベアラー認証情報には、バックエンドの通常の権限チェックが適用されます。

docker build -t dactic-mcp:local .
docker run --rm -i -e DACTIC_MCP_TOKEN dactic-mcp:local

これは、ホスト環境にすでに設定されている環境変数を使用します。stdout はクリーンな MCP ストリームを維持する必要があるため、-t は使用しないでください。ヘッドレスの Docker ではベアラー認証情報が必要です。このコンテナーでは、対話型のブラウザー OAuth コールバックは設定されていません。

設定と診断

変数	動作
DACTIC_MCP_TOKEN	任意のベアラー認証情報です。省略するとブラウザー OAuth を使用します
DACTIC_REQUEST_ID	任意の安全な相関 ID です。指定しない場合は UUID が作成されます
MCP_REMOTE_CONFIG_DIR	任意の OAuth キャッシュディレクトリです。認証情報が含まれます
DACTIC_MCP_URL	本番環境の URL、またはローカル検証用のループバックフィクスチャです

OAuth では、基本スコープ openid offline_access mcp/mcp:tools が要求されます。 追加の機能は、サーバーの認可とクライアントの同意によって異なります。 このランチャーは、デフォルトでは組織全体の利用スコープを要求しません。 OAuth の保存と更新は mcp-remote が処理し、通常は ~/.mcp-auth に保存されます。このキャッシュはパスワードと同様に保護し、共有しないでください。

ブリッジはプロトコルメッセージのみを stdout に書き込みます。JSON のライフサイクル診断は stderr に request_id とともに出力され、この ID はサービスにも X-Request-ID として送信されます。 ログは接続障害を分類し、安全なスタック関数フレームを保持します。上流のレスポンス本文、 認可 URL、認証情報は破棄されます。request_id とイベント bridge.fail または bridge.dependency.fail で診断情報を検索してください。接続確立のタイムアウトは、 接続が15秒、ヘッダーが60秒、本文のアイドルが300秒、ブラウザー認可コールバックが120秒に 設定されています。

認証に失敗した場合は、ホストのサインインフローを使って再接続してください。権限エラーの場合は、 アカウントへのアクセス権を確認してください。認証を繰り返しても、新しい権限は付与されません。 ネットワークエラーの場合は、エンドポイントの可用性とネットワークを確認してください。 サポートに共有するのは相関参照情報だけにしてください。

公開ソースの範囲

公開コードは、トランスポートと統合設定を実装しています。取得エンジン、内部プロンプト、 データベースアクセス、本番インフラストラクチャ、顧客のフィクスチャは含まれていません。 サービスから返されるツールの説明とスキーマは MCP クライアントから参照でき、 ディレクトリの検査時に取得される場合があります。 レビュー範囲、セキュリティ、 Dactic のプライバシーポリシーを参照してください。

開発

npm run verify は、公式スキーマのスナップショット、マニフェストの整合性、 アセット、パッケージ化の境界、および合成ループバック MCP サーバーに対する オフラインのプロトコル統合テストを検証します。テストでは Dactic に接続せず、 ユーザー認証情報も読み取りません。CI では同じチェックを実行し、非 root の Docker イメージをビルドします。 CI ではレジストリやマーケットプレイスへの公開は行いません。

ソースは MIT ライセンスで提供されています。ブランディングとホスト型サービスは このライセンスの対象外です。NOTICEを参照してください。