MCP 應用程式讓 Dokki Copilot 或 Agent 透過您授權的帳戶使用外部服務。使用本指南來連接、使用、檢視和斷開這些帳戶。若要比較 AI 用戶端、Workspace MCP 連接器、MCP 應用程式、聊天頻道和 Agent MCP，請從 連接 開始。
什麼是 MCP 應用程式
MCP 應用程式是從 Dokki 到外部服務的對外連接，例如 GitHub、Slack、Gmail、日曆、雲端硬碟、問題追蹤器或其他受支援的工具組。
該連接屬於授權外部帳戶的 Dokki 使用者。
Dokki 可能使用 OAuth、API 金鑰表單或其他特定於提供者的憑證流程。
外部提供者自身的角色和權限仍然適用。
其他工作區成員不會自動繼承已連接的帳戶。
為某個已安裝的 Agent 設定的專用外部 MCP 伺服器屬於該 Agent 的 MCP 標籤，而非 MCP 應用程式。
連接 MCP 應用程式
開啟 工作區 → 擴充功能 → 連接 → MCP 應用程式。
按名稱搜尋服務。
開啟服務並選擇 連接。
完成提供者的 OAuth 頁面或憑證表單。
確認已選取預期的外部帳戶和組織。
返回 Dokki 並等待連接顯示為啟用狀態。
從唯讀任務開始，並驗證哪個帳戶回應。
如果提供者暫時無法使用或授權仍待處理，請重試現有流程，而不是建立重複的連接。
連接所有權與存取
兩個獨立的權限系統必須允許每個任務：
Dokki 權限 決定可以使用哪些工作區上下文、資源和 Agent 指示。
外部提供者權限 決定已連接的帳戶可以使用哪些儲存庫、頻道、信箱、日曆、雲端硬碟、專案或動作。
一方的存取權限絕不會擴展另一方。已連接的 GitHub 帳戶無法揭露私有的 Dokki 文件，而對 Dokki 文件的存取權限也無法授予儲存庫的存取權限。
從 Copilot 使用 MCP 應用程式
要求特定的服務、目標和動作。當介面支援應用程式提及時，請明確選取 MCP 應用程式，以便目前回合僅載入相關的外部工具。
「讀取已連接儲存庫中的未解決問題，並在此文件中摘要。」
「根據此專案簡報草擬一封電子郵件，但不要傳送。」
「列出明天的日曆事件，並將準備任務新增到此表格。」
在進行變更之前，請確認外部帳戶、儲存庫、頻道、信箱、日曆、雲端硬碟或專案。草擬的請求並不代表提供者已接受變更；請回頭讀取結果。
從 Agent 使用 MCP 應用程式
開啟 Agent 控制面板並檢視其目的和指示。
限制 Agent 的 Dokki 工作區存取權限。
確認 Agent 將透過哪個使用者的 MCP 應用程式連接來執行。
檢視排程、無人觸發和傳遞目的地。
先執行一個手動的唯讀任務。
在允許重複變更之前，請檢查 Agent 執行和外部提供者的結果。
Agent 指示無法覆寫 Dokki 或提供者的授權。移除工作區、帳戶連接或 Agent 權限可以停止後續執行。
透過已連接的應用程式匯入
某些提供者也支援 Dokki 的引導式匯入和單向同步流程。
開啟目的地資料夾並選擇 匯入。
選取或管理提供者連接。
選擇個別項目、受支援的 URL 或 ID，或明確確認全面的匯入。
在可用時選擇一次性匯入或單向同步。
檢視佇列中、執行中、已完成和失敗的項目。
從結果連結開啟已完成的 Dokki 資源。
中斷應用程式的連接會停止未來的匯入或重新整理。這不會刪除已建立的 Dokki 資源。
確認重大動作
Dokki 在傳送訊息、變更外部資料、發佈內容或執行其他重大動作之前，可能需要確認。
在確認之前，請識別執行的使用者或 Agent、Dokki 來源上下文、選取的 MCP 應用程式和外部帳戶、外部目標、請求的變更和驗證方法。
檢視作用中的連接
提供者和外部帳戶識別資訊。
連接狀態和最後一次成功使用。
指向不同帳戶的重複連接。
哪些 Copilot 或 Agent 工作流程仍依賴該連接。
帳戶是否仍屬於正確的人員或團隊。
中斷連接或重新連接
當帳戶錯誤、不再需要存取權、憑證可能已洩露、Agent 或自動化已停用，或提供者要求重新授權時，請中斷連接。
當提供者回報授權已過期或無效時，請重新連接。重新連接後請再次驗證外部帳戶，因為現有的瀏覽器工作階段可能選取不同的帳戶。
中斷連接會停止 Dokki 未來使用該連接。這不會撤銷已建立的訊息、問題、檔案、事件、匯入或其他變更。
疑難排解
應用程式未列出 — 依提供者名稱或工具包 slug 搜尋；可能不受支援或暫時無法使用。
授權頁面無法開啟 — 從 連線 → MCP 應用程式 重新啟動，並允許提供者的登入視窗。
連線維持待處理 — 完成提供者頁面，返回 Dokki，並重新整理狀態，而不建立重複項目。
外部帳戶錯誤 — 中斷連線，登入預期的提供者帳戶，然後重新連線。
Copilot 無法看到應用程式 — 確認其為啟用狀態，明確選擇或提及它，並開始新的回合，以便工具重新整理。
Agent 無法使用應用程式 — 檢查 Agent 設定、工作區存取權、執行使用者擁有權、排程身分和連線狀態。
讀取成功但寫入失敗 — 檢查提供者的寫入權限、受保護的目標和必要的確認。
Dokki 資源無法使用 — 修正 Dokki 工作區或資源存取權；MCP 應用程式無法繞過它。
匯入停止更新 — 檢視提供者連線以及匯入或同步狀態。
安全連線實務
連線能完成任務的最小外部帳戶。
優先明確選擇應用程式，而非載入每個可用的外部工具。
將憑證保留在託管的授權流程或經核准的安全表單中。
切勿將 API 金鑰或 bearer token 貼到文件、聊天、Agent 指令或記憶體中。
在任何連線變更後，檢閱無人值守的 Agent 排程。
中斷過時帳戶的連線，並確認未來的呼叫會失敗。
只有在提供者讀回之後，才將重要的外部寫入視為完成。