MCP 連線指南

什麼是 MCP？

Model Context Protocol (MCP) 是 Anthropic 制定的開放標準協定，讓任何支援 MCP 的 AI 助理能夠安全地存取外部系統。透過 MCP，AI 助理可以直接與 Squid API 互動，執行專案管理、需求追蹤、計畫排程等操作。不限於特定廠商或平台。

開始之前

①

Nautilus 帳號

您需要一個 Nautilus 帳號來登入。如果還沒有帳號，請前往 Nautilus 註冊。

②

MCP 客戶端

任何支援 MCP 協定的客戶端，例如 Claude Desktop、Claude Code 或其他第三方實作。

服務端點

端點	URL
MCP Server	`https://mcp-server-production-f4cuesozga-de.a.run.app/mcp`
Health Check	`https://mcp-server-production-f4cuesozga-de.a.run.app/health`
OAuth2 Discovery	`https://mcp-server-production-f4cuesozga-de.a.run.app/.well-known/oauth-authorization-server`

認證架構

MCP Server 透過 Nautilus 完成 OAuth2 認證，全程自動處理

💬

MCP Client

Claude Desktop / Code

①→

🔌
MCP Server
Discovery + Proxy

②→

🔐

Nautilus

Authorization Server

③→

🦑

Squid API

Resource Server

① Discovery

MCP Client 向 MCP Server 取得 OAuth2 Metadata，得知 Nautilus 的授權端點位置。

② 使用者登入

瀏覽器開啟 Nautilus 登入頁面，使用者以 Nautilus 帳號授權後，簽發 JWT Token。

③ API 調用

MCP Server 以 Token 代理調用 Squid API，後續自動刷新，無需手動操作。

43 個可用工具

連線後，Claude 可以使用以下工具管理您的 Squid 系統

需求單管理 8

需求工單的建立、查詢、更新、刪除、狀態變更、列表查詢、驗證報告、計畫關聯

專案管理 9

專案的建立、查詢、更新、刪除、封存、狀態變更、列表查詢、進度追蹤、計畫關聯

類別管理 6

類別的建立、查詢、更新、刪除、停用、列表查詢

計劃管理 9

計劃的建立、查詢、更新、刪除、狀態管理、部分更新、版本建立與列表、需求關聯

提案管理 5

專案提案的建立、查詢、詳情檢視、版本建立與列表

驗證報告 3

驗證報告送出、查詢、評分計算與統計

儀表板 3

系統總覽統計、狀態分布、近期活動追蹤

連線設定步驟

1

設定 MCP 客戶端

Squid MCP Server 採用 OAuth2 自動認證。您只需加入 MCP Server URL，客戶端會自動透過 OAuth2 Discovery 完成認證流程。

以下是常見的 MCP 客戶端設定範例（支援任何相容 MCP 協定的客戶端）：

💬

範例：Claude Desktop

編輯設定檔：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

加入以下內容：

                                    
{

  "mcpServers": {

    "squid": {

      "url": "https://mcp-server-production-f4cuesozga-de.a.run.app/mcp"

    }

  }

}

儲存後重啟 Claude Desktop，首次連線時會自動開啟瀏覽器進行 OAuth2 登入。

⌨️

範例：Claude Code (CLI)

在終端機執行以下指令：

claude mcp add squid \
https://mcp-server-production-f4cuesozga-de.a.run.app/mcp \
--transport http

新增後，首次使用 MCP 工具時會自動觸發 OAuth2 認證流程。

2

登入授權

首次使用 MCP 工具時，系統會自動引導您完成登入：

瀏覽器自動開啟
MCP 客戶端會自動開啟瀏覽器，導向 Nautilus 登入頁面。
輸入帳號密碼
使用您的 Nautilus 帳號登入。如果還沒有帳號，可以在登入頁面點選「立即註冊」。
看到「認證成功」
授權完成後，瀏覽器會顯示綠色勾勾和「認證成功」訊息。此時可以關閉瀏覽器。
回到客戶端開始使用
回到您的 MCP 客戶端，工具已準備就緒。

登入後，系統會自動維護您的登入狀態。Token 過期時會在背景自動刷新，不需要重新登入。

3

驗證連線

設定完成後，在 AI 助理對話中輸入以下指令來測試：

測試指令

請列出所有專案

如果看到專案列表（即使是空的），表示連線成功。

手動健康檢查

curl https://mcp-server-production-f4cuesozga-de.a.run.app/health

預期回傳 {"status":"healthy", ...}

使用範例

連線成功後，您可以用自然語言與 AI 助理互動來管理 Squid 系統：

專案管理

「請列出所有進行中的專案」
「建立一個名為『新電商平台』的專案」
「將專案 XXX 的狀態改為 completed」

需求管理

「列出專案 XXX 的所有需求」
「建立一張需求工單，標題為...」
「將需求 XXX 狀態改為 in_progress」

計畫管理

「為這個專案建立開發計畫」
「列出目前所有進行中的計畫」
「將計畫 XXX 的狀態改為已完成」

儀表板與統計

「顯示系統總覽統計」
「查看各專案的進度」
「列出最近的活動記錄」

技術規格

MCP 協定版本	2024-11-05
Transport	Streamable HTTP
認證方式	OAuth2 (自動 Discovery + Bearer Token)
回應格式	JSON-RPC 2.0
Content-Type	`application/json`
Accept	`application/json, text/event-stream`
部署環境	GCP Cloud Run (asia-east1)
工具數量	43 個 MCP Tools

常見問題

Q: 連線失敗 (Connection refused)

請確認 MCP Server 正在運行：