Kabo MCP 文件

快速入門

幾分鐘就能完成連接。

只要用戶端能透過 HTTP 新增遠端 MCP 伺服器，並能用 OAuth 登入，就能使用 Kabo。各家選單名稱不同，但步驟相同。

1. 新增遠端伺服器

   打開用戶端的 MCP 或連接器設定，新增一個伺服器，網址填 https://kabo.sh/mcp-pub。

2. 登入 Kabo

   用戶端會在瀏覽器開啟 Kabo 的登入頁。登入或註冊帳號，確認 Kabo 要求的權限，然後核准。

3. 檢查可用工具

   請助理以空物件呼叫 get_research_capabilities，查看你的帳號目前可用的資料研究工具。這項檢查不會消耗額度。

{
  "mcpServers": {
    "kabo": {
      "url": "https://kabo.sh/mcp-pub"
    }
  }
}

如果你的用戶端用 JSON 檔設定，項目通常長這樣。不同用戶端的欄位名稱不同，請以它的文件為準。

Skills

為現有 MCP 連線安裝 Skills。

已經連線了嗎？Kabo 的十個選用 Skills 提供帳號檢視、趨勢研究、競爭對手分析、影片分析、創意與腳本工作流程，沿用現有的 MCP 連線與 Kabo 登入狀態。僅連接 MCP 不會自動安裝 Skills。

Kabo Skills 可用於電腦、遠端工作區或雲端環境中的相容 agent。Codex、Claude Code 和 Cursor 只是範例，並不是完整的支援清單。

Agent 的執行環境需要能載入 SKILL.md 及隨附檔案、使用 Python 3 執行所需指令碼，並呼叫你已授權的 Kabo MCP 連線。是否相容取決於這些能力，而不是介面是桌面應用程式還是網頁。

官方儲存庫與 README
https://github.com/kabo-sh/kabo-mcp-plugin

方式一：複製 GitHub 儲存庫

git clone --branch stable --single-branch https://github.com/kabo-sh/kabo-mcp-plugin.git

複製儲存庫後，設定 agent 從 kabo-mcp-plugin/skills/ 載入完整的 Skill 資料夾，或將這些資料夾複製、匯入至它支援的 Skills 位置。保留所有指令碼、參考資料和資源檔案。僅複製儲存庫不會自動向 agent 註冊 Skills。

方式二：使用 skills CLI（npx）

skills CLI 只是選用的安裝方式。也可以直接複製 GitHub 儲存庫或下載 ZIP，依你的環境與偏好選擇即可。

npx skills add 'kabo-sh/kabo-mcp-plugin#stable' --skill '*'

在專案目錄執行此指令，並在安裝程式中選擇使用的用戶端。預設只安裝到目前專案；加上 -g 即可安裝到使用者目錄，供所有專案使用。

CLI 用戶端參數範例：--agent codex、--agent claude-code 或 --agent cursor。這些範例不限定哪些 agent 可以使用 Kabo Skills。

執行 npx skills list 查看安裝結果；全域安裝則使用 npx skills list -g。開啟新的用戶端工作階段以載入 Skills。

方式三：下載 ZIP

Release ZIP 是完整外掛套件。若要手動只安裝 Skills，請將 skills/ 下的每個完整資料夾複製到用戶端支援的 Skills 目錄，保留程式碼、參考資料與資源檔案。僅複製 SKILL.md 並不足夠。手動複製的內容不會由 CLI 更新程式追蹤。

版本與更新

stable 分支會跟隨已發布版本。已安裝的 Skills 不會在背景自動更新。您可以在 GitHub Releases 查看新版本與版本資訊，再決定何時更新。

git -C kabo-mcp-plugin pull --ff-only

對於 stable 分支的儲存庫複本，在包含 kabo-mcp-plugin 的目錄中執行此指令。如果曾將 Skill 資料夾複製或匯入其他位置，也需要替換那些複本。透過 Git 或 ZIP 安裝的內容不由 skills CLI 更新工具追蹤。

透過 skills CLI 安裝的 Skills，請依安裝範圍選擇更新指令：

npx skills update -p

npx skills update -g

這些指令會更新所選範圍內所有已追蹤的 Skills，包括其他來源。只想更新 Kabo 時，請再次執行安裝指令，沿用相同用戶端與專案或全域安裝範圍。

在 skills CLI 1.7.4 中，skills check 會執行更新邏輯，可能取代已安裝的檔案。若只想了解更新而不更動安裝內容，請查看版本發布頁面。

將 #stable 換成 #v1.0.1 即可固定使用該版本。更新固定版本的安裝不會切換至新 tag；升級時需要明確安裝新的 tag。

已驗證的用戶端與工作流程需求請參閱 README。安裝成功不代表已完成整個工作流程的驗證。

工具

助理可以呼叫的工具。

透過用戶端的 tools/list 請求查看目前的工具及輸入格式。以下是常用的入門工具。

這個伺服器還提供 YouTube、Instagram 和 TikTok 的公開資料工具：個人檔案、貼文、留言、逐字稿、搜尋和熱門音樂榜。

查看結果，無須重新執行

針對資料工作，將 job_id 傳給 get_research_data_job，並使用 read_research_data_artifacts 讀取產出檔案。針對影片分析，將傳回的 id 傳給 get_analysis_run。工作尚在處理時請查詢進度，不要重新啟動。

身分驗證

使用你的 Kabo 帳號登入。

登入方式：使用 PKCE 與動態用戶端註冊的 OAuth，不必複製 API key

OAuth 資源

https://kabo.sh/mcp-pub

支援的權限範圍

offline_accessopenidprofileemaildatavideoworkspace:readworkspace:write

伺服器中繼資料：

https://kabo.sh/.well-known/oauth-protected-resource/mcp-pub

OAuth 資源必須與上方的伺服器端點完全相符。為 /mcp 或其他端點核發的權杖無法在此使用。

不用瀏覽器登入

如果你的 MCP 用戶端執行在打不開瀏覽器、也收不到 OAuth 重新導向的環境（例如遠端伺服器或無介面終端機），可以改用 OAuth 裝置碼流程（RFC 8628）登入。請使用下方的固定用戶端 ID；透過動態用戶端註冊取得的用戶端 ID 無法用於裝置碼登入。

用戶端 ID

kabo-mcp-pub

裝置授權端點

https://kabo.sh/api/auth/device/code

確認頁面

https://kabo.sh/device

curl -X POST https://kabo.sh/api/auth/device/code \
  -H 'content-type: application/json' \
  -d '{"client_id":"kabo-mcp-pub","scope":"openid offline_access data video"}'

curl -X POST https://kabo.sh/api/auth/oauth2/token \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=DEVICE_CODE \
  -d client_id=kabo-mcp-pub

回應中有 user_code 和 verification_uri_complete 連結。在任何裝置上開啟連結、登入 Kabo，並核對驗證碼是否相符。同時依照回傳的 interval 輪詢權杖端點，直到它不再回傳 authorization_pending，而是回傳存取權杖。scope 必須包含 offline_access，其餘可從上方支援的權限中選擇。權杖只能用於上方的伺服器端點，過期後用更新權杖續期。

裝置碼 15 分鐘後過期（見回應中的 expires_in）。輪詢間隔不要短於 interval，也就是 5 秒；伺服器回傳 slow_down 時再加 5 秒。authorization_pending 表示用同一個裝置碼繼續輪詢。expired_token 表示裝置碼已過期，需要重新申請。access_denied 表示使用者拒絕了，請停止，不要自行重試。裝置碼仍有效時不要再申請新的：每次申請都會產生一組新碼，只有使用者確認的那一組能完成登入。

裝置碼登入不需要 resource 參數。核發給 kabo-mcp-pub 的權杖一律綁定在上方的伺服器端點。

權限與對應的功能

只申請任務需要的權限。每個工具檢查一項權限，缺少時回傳 403 insufficient_scope，並寫明缺的是哪一項。

offline_access

取得更新權杖所必需。沒有它，2 小時的存取權杖過期後工作階段就會結束。裝置碼登入必須包含。

openidprofileemail

只用於登入身分，不開放任何工具。profile 讓 get_kabo_info 回傳你的名字和大頭貼，email 讓它回傳你的電子郵件。

data

公開研究資料：趨勢與查詢工具、研究資料工作以及 get_research_capabilities。

video

已儲存影片的分析與影片復刻。開始新的分析需要 Kabo Pro，並需經你確認。

workspace:read

讀取你的 Kabo 工作區：Kabo 帳號資訊、已連結帳號、創作者資料、腳本和影片庫。

workspace:write

儲存和更新腳本，連結公開的創作者帳號。

在多個任務之間維持連線

存取權杖有效 2 小時。更新權杖有效 30 天，每用一次就換新，所以每組只能用一次。請把它們存在主機的安全憑證儲存區，不要寫進對話或一般記錄；同一時間只從一個地方更新：重複使用舊的更新權杖，會讓這個用戶端在該帳號下的所有工作階段一起登出。任務結束不必結束登入。如果你的環境在任務結束後保留不了憑證，請在登入前告訴使用者，下次需要重新登入。

使用額度與存取權限

連接免費。公開資料請求可能消耗帳號的每日額度。建立新的影片分析需要 Kabo Pro 與你的授權。檢查可用性及讀取結果不會消耗資料額度。

助理透過 Kabo 能看到什麼？

Kabo 為你的請求收集的公開創作者證據，以及你用自己的 Kabo 帳號發起的分析和研究任務。Kabo 讀不到其他使用者的任務，也讀不到任何人的私訊、草稿或不公開的數據。

不會。Kabo 只做研究和分析，不會在任何平台上發布、留言、傳訊息或編輯內容。

疑難排解

解決連接問題。

連線到 Kabo 的 agent應遵守以下規則。

1. 登入前先檢查

   先使用現有連線，只有伺服器回傳 401 時才重新登入。想在不消耗額度的情況下檢查連線，可以呼叫 get_research_capabilities 或 get_kabo_info。

2. 依任務申請權限

   研究資料申請 data，已儲存影片的分析申請 video，Kabo 工作區申請 workspace:read 或 workspace:write。不要預設申請全部權限，也不要漏掉任務需要的那一項。

3. 依錯誤對症處理

   401：登入。403 insufficient_scope：用錯誤中寫明的權限重新授權。invalid_client：檢查用戶端 ID。額度、訂閱、頻率或並行錯誤不是登入問題，不要請使用者重新登入。

4. 逾時後先檢查再重試

   請求可能已經執行了，先查看結果。儲存和更新類工具接受冪等鍵，原樣重試是安全的。

5. 只用一組裝置碼

   裝置碼仍有效時，繼續用它輪詢，不要申請新的。

6. Skills 不等於已連線

   Kabo Skills 已載入，不代表 Kabo MCP 伺服器已連線；外掛更新後，目前工作階段裡的工具也不會自動重新整理。使用前先確認 Kabo 的工具已經列出。