Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

註冊、測試及發布連結的應用程式

符合必要條件後，請按照下列步驟註冊、設定、測試及發布連結應用程式。

步驟 1：建立連結的應用程式

如要建立連結的應用程式，請按照下列步驟操作：

登入 Google Connected Console。
在首頁選取「建立應用程式」。
在「選擇要建立的項目」對話方塊中：
- 如果系統提示您接受《連結的應用程式服務條款》，請選取「View terms」(查看條款)，詳閱並接受協議，然後選取「Create」(建立)。只有帳戶管理員可以接受協議。
- 如果沒有，請選取「連結的應用程式」資訊卡中的「建立」。
在「為連結的應用程式命名」對話方塊中，輸入連結應用程式的名稱。這個名稱會用於在 Google 產品中顯示連結的應用程式，也是使用者用 @ 提及連結應用程式的方式。選取「下一步」。
在「Select a connected app category」(選取連結應用程式類別) 對話方塊中，從「Select a category」(選取類別) 選單選取應用程式的網域、類別或產業。

注意：您的應用程式類別會定義基本功能需求，設定後即無法變更。如要改用其他類別，則須建立新的連結應用程式。
在「Choose connection type」(選擇連線類型) 對話方塊中，選擇下列其中一個選項：
- MCP 伺服器：連結 MCP 伺服器，在網頁、Android 和 iOS 平台，為 Gemini 和 Google 搜尋使用者提供服務。
- Android MCP：向 Android 版 Gemini 公開裝置端功能，讓 Gemini 觸發動作，並在應用程式中為使用者完成工作。
進一步瞭解如何設定 Android MCP 連結應用程式。每個連結應用程式只能選擇一種連結類型，且日後無法變更。
選取「建立連結的應用程式」。

系統會開啟連結應用程式的管理總覽頁面 (設定及測試連結的應用程式)，您可以在此設定應用程式詳細資料、MCP 伺服器連線和測試人員。

步驟 2：輸入連結應用程式的詳細資料

如要提供連結應用程式的詳細資料，並設定向使用者顯示的方式，請按照下列步驟操作：

在連結應用程式的總覽頁面中，選取「應用程式詳細資料」列中的「開始使用」(如要更新現有詳細資料，請選取「管理」)。
在「App details」(應用程式詳細資料) 頁面頂端，確認「Connected app name」(連結的應用程式名稱) 欄位。您可以視需要更新名稱。這個名稱會顯示在各項 Google 產品中，也能供使用者加上 @ 來提及您的應用程式。
在「Public details」部分的「Icon」下方，上傳應用程式圖示 (JPG 或 PNG，大小不超過 1 MB，尺寸為 512 px × 512 px)。
填寫下列欄位：
- 說明：輸入簡潔的單句摘要 (不超過 30 個字)，說明連結應用程式的主要功能和用途。這段文字會向使用者顯示，不會做為模型指令。
- 功能：輸入至少三項連結應用程式可執行的重要工作。選取「Add capability」即可新增更多項目。請勿在功能開頭使用數字。每個項目只能包含一項功能。如果類別包含預先定義的功能，這些功能會顯示在清單頂端，且無法修改。
- 範例提示詞：輸入至少三個範例提示詞，協助使用者瞭解可以提出哪些問題。選取「Add example prompt」(新增範例提示) 即可新增項目。
  - 請將至少兩則提示詞以 @<YourAppName> 開頭 (例如 @Order Tracker where is my last order?)。
  - 在至少一則提示中自然提及 <YourAppName>，開頭不使用應用程式名稱 (例如 Track my recent order on Order Tracker)。
  - 請勿加入編號前置字元 (1.、2.、3.)，或用引號 ("...") 括住提示詞。
- 多語言本地化：如要提供「Description」(說明)、「Capabilities」(功能) 和「Example prompts」(提示範例) 的翻譯，請在輸入欄位中，將各語言代碼的文字加上語言標記。例如：
```
<en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>
```
  Google Connected Console 會自動驗證標記，並在每個欄位下方顯示偵測到的語言代碼 (例如 Found translations for 2 languages: en-US, es-ES)。
- 服務條款網址：輸入有效的 https:// 或 http:// 服務條款連結。
- 政策網址：輸入有效的 https:// 或 http:// 隱私權政策連結。
- 網站網址 (選填)：輸入網站連結，用於標示出處。
選取頁面底部的「儲存」，返回總覽頁面。

步驟 3：輸入 MCP 端點並驗證網域擁有權

Google 必須先取得 MCP 伺服器端點網址，並驗證您擁有託管該伺服器的網域，才能連線至 MCP 伺服器或同步處理工具。

如要輸入 MCP 端點並驗證網域擁有權，請按照下列步驟操作：

在已連結應用程式的總覽頁面中，選取「MCP 和工具設定」資訊卡中的「開始使用」(如要更新現有詳細資料，請選取「管理」)。系統會開啟 MCP 設定流程的步驟 1 (MCP 伺服器端點)。
在「已連結 MCP 伺服器端點」下方，輸入 MCP 伺服器端點的完整 HTTPS 網址 (例如 https://api.yourdomain.com/v1/mcp)。
在「Verify your domain」(驗證網域) 下方，完成網域的驗證權杖驗證 (如果您已在開發人員帳戶中驗證網域或其上層網域，系統會自動顯示為已驗證)：
1. 在「驗證網域擁有權」資訊卡中，選取「下載權杖」。瀏覽器會下載名為 google-connected-apps.json 的檔案，結構如下：
```
{
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}
```
2. 上傳這項 JSON 內容，並在伺服器上託管，網址為 https://<your-domain>/.well-known/google-connected-apps。
  - 請確認端點可透過 HTTPS 公開存取、直接傳回 HTTP 200 OK (不含 HTTP 重新導向)，且 verification_tokens 陣列中包含您的權杖。
3. 返回 Google Connected Console，然後選取「驗證網域」。
4. 驗證成功後，「Domain verified with challenge token」(已使用驗證權杖驗證網域) 列會顯示綠色勾號，並解鎖下方的「Access credentials」(存取憑證) 部分。

步驟 4：設定存取憑證

驗證網域後，請設定 Google 如何向 MCP 伺服器驗證，並擷取伺服器的工具定義。

如要設定存取憑證，請按照下列步驟操作：

在「Provide access credentials」(提供存取憑證) 部分 (位於「MCP and tools setup」(MCP 和工具設定) 頁面的步驟 1)，選取「Get started」(開始使用) (或「Update credentials」(更新憑證)，修改現有設定)。
在「Does your server require authorization?」(您的伺服器是否需要授權？) 下方，選取下列其中一個選項：
- 否：如果 MCP 伺服器可公開存取，不需驗證，請選取這個選項，然後選取「確認」。
- 是：如果 MCP 伺服器提供的任何工具需要授權，請選取這個選項。接著，在「Select the authorization model your MCP server uses」(選取 MCP 伺服器使用的授權模式) 下方，選擇驗證流程：
  - 機器對機器 (OAuth 用戶端憑證)：如要進行服務對服務驗證 (RFC 6749)，請選取這個選項。Google 會使用共用的用戶端 ID 和 Secret，直接與您的 MCP 伺服器通訊，不需重新導向使用者登入：
    1. 輸入用戶端 ID (必填) 和用戶端密鑰 (選填)。
    2. 如果伺服器未使用 /.well-known/oauth-authorization-server 公開授權端點和權杖端點，您可以視需要輸入「Authorization endpoint」(授權端點) (選填) 和「Token endpoint」(權杖端點) (選填)。
    3. 選取「註冊用戶端」(或「更新用戶端」)。
  - 使用者委派 (授權碼)：如果 MCP 伺服器需要個別使用者透過 Google 帳戶連結，以個人帳戶登入並授權操作，請選取這個選項：
    1. 將 Google 的 OAuth 重新導向 URI 加入許可清單：在「Ensure you have allow listed the provided redirect URIs」橫幅中，選取「View」(或選取複製圖示)，查看系統為連結應用程式產生的確切應用程式專屬重新導向 URI。將這些 URI 新增至 OAuth 伺服器的許可清單，然後返回 Google Connected Console。
    2. 在「Select how Google should authenticate with your OAuth server」(選取 Google 應如何向 OAuth 伺服器驗證) 下方，選取 OAuth 用戶端的註冊方式：
      - 預先註冊：如果您在 OAuth 供應商中產生靜態用戶端 ID 和用戶端密鑰 (選用)，請選擇這個選項。您也可以視需要提供「Custom authorization endpoint (optional)」(自訂授權端點 (選填)) 和「Custom token endpoint (optional)」(自訂權杖端點 (選填))。
      - 用戶端 ID 中繼資料或 Dynamic Client Registration (建議)：如果伺服器支援 OAuth 用戶端 ID 中繼資料文件 (CIMD) 或 Dynamic Client Registration (RFC 7591)，請選擇這個選項。Google 會先檢查 CIMD，然後使用 .well-known 探索端點，改用 DCR。您也可以視需要指定自訂授權和權杖端點。
    3. 在「Authenticate with your developer credentials」(使用開發人員憑證進行驗證) 下方，由於您已選取「User-delegated」(使用者委派) 做為授權模式，因此必須先登入伺服器，Google 才能擷取工具。選取下列其中一項：
      - 透過彈出式視窗驗證 (建議)：在疊加對話方塊中展開驗證流程。這是預設體驗。
      - 透過重新導向驗證 (備用)：在同一個分頁或視窗中，以全螢幕重新導向的方式開啟驗證流程。如果對話方塊因顯示限制或安全性標頭 (例如 X-Frame-Options 或 Content-Security-Policy) 而無法顯示，請使用這個選項。
      建議您先嘗試使用對話方塊進行驗證。如果無法使用對話方塊進行驗證，請改用重新導向方法。您的選擇也會決定使用者首次使用連結應用程式時的登入體驗。
    4. 選取「註冊用戶端」(或「更新用戶端」)。
注意：如果選取「使用者委派」做為授權模式，系統只會在擷取工具時要求驗證。如果開發人員帳戶中的其他帳戶正在處理連結的應用程式，則必須先驗證身分，才能重新同步工具。

步驟 5：提供測試帳戶詳細資料 (僅適用於使用者委派授權)

如果連結的應用程式需要驗證，您必須提供預先填入實際樣本資料的測試憑證，並停用雙重驗證 (2FA)，同時向 Google 代表提供測試操作說明。這樣一來，Google 的審查和品質確保團隊就能驗證工具執行情況，不會受到空白沙箱、付費牆或雙重驗證挑戰的阻礙。如果 Google 無法完整測試連結的應用程式，可能會在審查期間拒絕。

步驟 6：同步處理工具

為建立連結應用程式的各個版本，Google 會與您提供的端點同步，取得可用工具並建立快照。這些是該版本使用者可用的工具。連結的應用程式版本處於預先發布版，且可供測試人員使用時，您可以繼續在伺服器上進行變更，並重新同步工具來更新。這會建立工具的新快照。

發布時，系統會使用工具的最新快照，做為連結應用程式的版本。您將無法再變更工具、說明或伺服器詳細資料。如要更新工具或同步處理伺服器的任何修改內容，請建立新的連結應用程式版本。建議您為每個版本的連結應用程式建立新的端點。

如要同步處理工具，請按照下列步驟操作：

在「同步處理工具」部分：
1. 選取「同步工具」。
2. 如果系統提示您登入，請使用具備相應權限的開發人員帳戶進行驗證，以便列出您要向使用者顯示的所有工具。帳戶無法存取的工具不會同步。
3. 連結完成後，Google Connected Console 會顯示已同步的工具數量，以及「重新同步處理工具」按鈕。
注意：如果 Google Connected Console 顯示「必須修正」錯誤資訊卡，或同步資訊卡下方顯示連線錯誤 (例如缺少 /.well-known/ 探索檔案、不支援的 UI 資源 MIME 類型，或 UI 資源大小累計超過上限)，請先解決問題再繼續操作。如需解決方案，請參閱「排解註冊問題」。
選取頁面底部的「Next」(下一步)，前往 MCP 和工具設定的步驟 2。

步驟 7：判斷使用者體驗應用程式的方式和位置

在「MCP 和工具設定」頁面的「工具」部分，設定基本參數，例如連結的應用程式適用的地理位置、語言，以及要提供該應用程式的 Google 產品。

在「Availability」(可用性) 下方的「Make version available in」(提供版本) 旁邊，設定下列指定選項：
- 國家/地區：選取連結應用程式適用的地理位置。
- 語言：選取連結應用程式支援的語言。
- 產品：選取可使用連結應用程式的 Google 產品。
在「可用性」下方的「工具」部分，查看從 MCP 伺服器同步的工具。在「Tools」清單中選取任一工具，即可在右側的「Manage tool」面板中調整設定：
- 啟用工具：切換「啟用工具」開關，即可在連結的應用程式中加入或排除工具。停用的工具不會出現在連結的應用程式中，使用者無法與其互動。
- 其他背景資訊：選取工具是否需要 Google 的情境信號才能運作：
  - 語言代碼：使用者 Google 帳戶所設定的語言代碼。
  - 大概位置：大於或等於 3 平方公里區域內的使用者或裝置位置，例如使用者所在的城市。
  - 精確位置：使用者或裝置的實際位置，定位精確度在 50 公尺以內。
  注意：除非有明確的需求和目的，否則不應要求額外情境。如果工具要求的背景資訊超出必要範圍，連結的應用程式可能無法通過審查。
- 使用者確認：選取「需要使用者確認」，即可要求使用者明確確認後再執行工具 (如果工具的 MCP 註解指定 destructiveHint: true，系統會自動預先選取這個選項)。
如果 MCP 伺服器提供 UI 資源，請切換至「工具」旁的「UI 資源」分頁，檢查伺服器的 UI 資源 (text/html、text/html;profile=mcp-app、text/javascript、text/css)，確認哪些工具連結至各項資源，並查看內容安全政策 (CSP) connectDomains 和 resourceDomains。

注意：連結應用程式的 MCP 應用程式目前為 Beta 版，可能無法使用。如果偵測到伺服器上有 UI 資源，系統可能會忽略這些資源。
選取頁面底部的「儲存」。

儲存「應用程式詳細資料」和「MCP 與工具設定」後，您新增的所有測試人員都能自動預覽設定，總覽頁面上的版本狀態也會更新為「可供測試人員使用」。

步驟 8：測試連結的應用程式

如要讓測試人員使用連結的應用程式，您必須在「管理測試人員」畫面中新增測試人員。只有新增至測試人員名單的使用者，才能查看未發布的連結應用程式並與其互動。您只能新增擁有 @gmail.com 帳戶的測試人員。

在連結應用程式的總覽頁面，找到「測試應用程式」資訊卡，然後選取「新增測試人員」(如果已新增測試人員，則選取「管理測試人員」)。
在「Manage testers」(管理測試人員) 畫面中，選取現有的電子郵件名單，或選取「Create email list」(建立電子郵件名單)，新增有權測試整合項目的 Google 帳戶。如要自行測試應用程式，請務必加入自己的電子郵件地址。
選取「儲存」。

注意：新增測試人員後，連結的應用程式最多可能需要 10 分鐘才會顯示在這些帳戶中。
Gemini 應用程式的測試人員只要輸入 @，並在後方加上連結的應用程式名稱，然後從選單中選取，即可叫用連結的應用程式。您也可以在 Gemini 中查看及連結應用程式，只要在左側導覽列中，依序前往「設定與說明」→「連結的應用程式」即可。
建議您徹底測試整合作業：
- 試用所有範例提示詞。
- 測試明確叫用 @<AppName> 和自然語言查詢。
- 驗證端對端驗證流程、工具執行、使用者確認提示，以及任何 UI 資源。
注意：您也可以在 Gemini 系列應用程式開發人員模式中偵錯連結的應用程式，以互動方式測試 Model Context Protocol (MCP) 伺服器、診斷結構定義或執行階段錯誤，以及評估工具品質，然後再將連結的應用程式提交至 Google Connected Console 審查。詳情請參閱「Gemini 系列應用程式開發人員模式總覽」和「在 Gemini 系列應用程式開發人員模式中測試、偵錯及評估」。請確認你已登入 Gemini 帳戶。

測試結果符合預期後，即可將連結的應用程式送交 Google 審查。

步驟 9：啟動連結應用程式的審查程序，並在通過後發布

連結的應用程式必須先通過 Google 審查和測試，才能開放給所有使用者。

如要將連結的應用程式送審，請按照下列步驟操作：

在連結應用程式的總覽頁面中，選取頁面右側「版本」資訊卡中的「送交審查」(應用程式設定完成且預覽時沒有阻礙問題，即可啟用)。
版本審查期間：
- Google Connected Console 會自動建立新的可編輯草稿版本，讓測試人員繼續預覽應用程式，您也可以準備日後編輯，不會中斷審查。
- 鎖定審查中版本的所有變更。
- 如要查看審查中版本的唯讀詳細資料或取消審查，請選取「審查中」資訊卡上的「更多選項」按鈕 (⋮)，然後選取「查看應用程式詳細資料」或「取消審查」。
Google 完成審查後，您會收到通知，且「Releases」(版本) 資訊卡會更新：
- 如果發現問題：「版本」資訊卡會顯示「發現問題」。選取「查看問題」，即可檢查特定審查結果。在可編輯的預先發布版中更新設定或 MCP 伺服器，與測試人員一起驗證修正項目，然後再次選取「送交審查」。
- 如果通過審查：「版本」資訊卡會顯示「已可發布」。準備好向使用者發布連結應用程式時，請選取「發布」。

恭喜！連結的應用程式已發布，並在您選取的 Google 產品中向使用者推出。

發布後和持續版本管理

發布後，「版本」下方的資訊卡會顯示「已發布」，以及連結應用程式的正式版號碼、發布日期，以及指定國家/地區、語言和產品的數量。您隨時可以選取「已發布」資訊卡上的「更多選項」選單 (⋮)，然後選取「查看應用程式詳細資料」，檢查正式版發布項目的唯讀設定。

已發布的版本會在正式版群組中保持上線狀態，您可以使用左側的「編輯及測試連結的應用程式」面板 (如果沒有草稿，請選取「建立新版本」)，在新版本 (Version <N+1>) 中獨立設定、預覽及測試更新，再送交審查及發布。