Copilot Studio Agent Direct Line MCP

🚀 ⭐ Copilot Studio Agent Direct Line MCP Server

このサーバーは、VS CodeまたはVS Code Insidersで、Copilot Studio Agent Direct Line MCP Serverを簡単にインストールできるようにします。これにより、コードエディタからDirect Line 3.0 APIを介して、Microsoft Copilot Studio Agentsと直接やり取りできます。

🚀 クイックスタート

概要

Copilot Studio Agent Direct Line MCP Server は、Microsoft Copilot Studio Agentのコンテキストを開発環境に持ち込みます。以下のようなプロンプトを試してみてください。

• "Start a conversation with my Copilot Studio Agent"
• "Ask my agent about product sizing"
• "Send a message to the agent: What are your capabilities?"
• "Get the conversation history"
• "End the current conversation"

期待されること

このサーバーは、簡潔でシンプル、焦点が絞られ、使いやすいツールで構築されています。それぞれのツールは特定のシナリオに設計されており、複雑で多機能なツールは避けています。Direct Line 3.0 APIの上に薄い抽象化レイヤーを提供し、エージェントとのやり取りを簡単にし、複雑な推論は言語モデルに任せます。

✨ 主な機能

• ✅ Direct Line 3.0 Integration - Microsoft Bot Framework Direct Line APIを完全にサポート
• ✅ Token Management - トークンの自動キャッシュと積極的なリフレッシュ
• ✅ Conversation State - 30分のアイドルタイムアウトで会話のライフサイクルを管理
• ✅ MCP Tools - エージェントとのやり取りに使用する4つのツール: send_message、start_conversation、end_conversation、get_conversation_history
• ✅ Comprehensive Error Handling - 11種類の特殊なエラータイプ、OAuth固有のリトライ戦略、MCPエラー変換
• ✅ Circuit Breaker Pattern - インテリジェントな障害分類、ユーザーエラーを回路状態から除外
• ✅ Retry Logic - ジッター付きの指数バックオフ、OAuth対応のリトライ戦略
• ✅ Input Validation - 型安全な検証のためのZodスキーマ
• ✅ Security - ログ内のシークレットマスキング、安全な環境構成、ディスクへの永続化なし
• ✅ HTTP Transport Mode - Azure Entra ID OAuth認証を備えたオプションのHTTPサーバー
• ✅ Testing Suite - 重要なコンポーネントに対して80%以上のカバレッジで45以上のテスト
• ✅ Production Ready - Azure Container Apps、Docker、Kubernetes用のデプロイメントテンプレート

⚒️ サポートされるツール

以下のツールを使用して、Copilot Studio Agentとやり取りできます。

• send_message: Copilot Studio Agentにメッセージを送信し、応答を受け取ります。
• start_conversation: エージェントと新しい会話を開始し、必要に応じて初期メッセージを付けることができます。
• end_conversation: 会話を終了し、リソースをクリーンアップします。
• get_conversation_history: 会話のメッセージ履歴を取得します。

📦 インストール

最高の体験を得るには、Visual Studio CodeとGitHub Copilotを使用してください。Claude CodeやCursorなどの他のツールでこのMCPサーバーを使用する方法については、getting started documentationを参照してください。

前提条件

1. VS Code または VS Code Insiders をインストールする
2. Node.js 18以上をインストールする
3. Direct Line 3.0が有効になっているMicrosoft Copilot Studio Agentを用意する
4. Copilot Studio AgentからDirect Lineシークレットキーを取得する

インストール方法

✨ ワンクリックインストール (推奨)

インストール後、GitHub Copilotのエージェントモードを選択し、ツールリストを更新してください。エージェントモードの詳細については、VS Code Documentation を参照してください。

🧨 NPXを使用した手動インストール

このインストール方法は、すべてのVisual Studio Codeユーザーにとって最も簡単です。

プロジェクトに .vscode/mcp.json ファイルを作成し、以下の内容を追加します。

{
  "inputs": [
    {
      "id": "direct_line_secret",
      "type": "promptString",
      "description": "Direct Line secret key from your Copilot Studio Agent"
    }
  ],
  "servers": {
    "copilot-studio-agent-direct-line-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "copilot-studio-agent-direct-line-mcp"],
      "env": {
        "DIRECT_LINE_SECRET": "${input:direct_line_secret}"
      }
    }
  }
}

ファイルを保存した後、MCPサーバーパネルで「Start」をクリックします。

チャットで エージェントモード に切り替えます。

「Select Tools」をクリックし、利用可能なツールを選択します。

GitHub Copilot Chatを開き、Start a conversation with my Copilot Studio Agent のようなプロンプトを試してみます。ツールを初めて実行するときは、Direct Lineシークレットを入力するように求められます。

💥 強くおすすめするのは、プロジェクトに .github/copilot-instructions.md を作成することです。これにより、GitHub Copilot ChatでCopilot Studio MCPサーバーを使用する際の体験が向上します。 最初に、コピロットの指示ファイルに "This project uses Microsoft Copilot Studio Agents. Always check to see if the Copilot Studio MCP server has a tool relevant to the user's request" を含めるだけです。

追加のインストール方法（ローカル開発環境のセットアップを含む）については、getting started documentation を参照してください。

📚 ドキュメント

トラブルシューティング

一般的な問題やログに関するヘルプについては、Troubleshooting guide を参照してください。

サンプルとベストプラクティス

サンプルプロンプトや使用パターンについては、Examples documentation を探索してください。

詳細なツールリファレンスや使用ガイドについては、Usage Guide を参照してください。

よくある質問

Copilot Studio Agent Direct Line MCP Serverに関する一般的な質問の回答については、Frequently Asked Questions を参照してください。

コントリビューション

コントリビューションを歓迎します！プレビュー期間中は、バグ、機能拡張、またはドキュメントの改善に関する問題を報告してください。

以下の内容については、Contributions Guide を参照してください。

• 🛠️ 開発環境のセットアップ
• ✨ 新機能の追加
• 📝 コードスタイルとテスト
• 🔄 プルリクエストのプロセス

行動規範

このプロジェクトは標準的なオープンソースコミュニティのガイドラインに従っています。すべてのコントリビューターは、相互に敬意を持ち、建設的なやり取りをすることを期待しています。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。

免責事項: これはBrad Stevensによる個人プロジェクトです。
このプロジェクトはMicrosoft Corporationとは関係がなく、Microsoft Corporationによって承認されているわけでもありません。