MCP 技術參考

當您需要傳輸詳細資訊、靜態憑據、功能限制或協議故障排除時,請使用此頁面。將 Kanera 連線到您的 AI 代理.

連線方法

連線	認證	有效獲得
互動式OAuth	瀏覽器登入並同意	充當具有讀寫工具功能的連線使用者。客戶控制操作的可用性和批准； Kanera 強制執行使用者的看板角色。它永遠不會接收工作區管理訪問許可權。
裝置授權	在任何裝置上的瀏覽器中批准的簡短使用者程式碼	充當批准使用者，與互動式 OAuth 完全相同。它永遠不會接收工作區管理訪問許可權。
無人值守代理	OAuth `client_credentials`	使用工作區服務身份,其上限為管理員選擇的最大讀取、寫入或管理許可權。管理員目前不會向預設 MCP 伺服器新增任何工具;使用單獨的工作區或板 API 金鑰進行直接 REST 管理。
個人 API 金鑰	靜態持有人令牌	在可訪問的板上充當其所有者。預設的 MCP 仍然以工作為中心；直接 REST 請求單獨繼承所有者支援的許可權。
工作區或板 API 金鑰	靜態持有人令牌	保持固定到其標準工作區或獨立板及其讀取、寫入或管理作用域。管理員不會向預設 MCP 新增配置工具。

海連線 AI 代理互動式 OAuth、同意、撤銷、無人值守代理和授權流程。

託管端點

Kanera 託管的 MCP 端點是:

https://mcp.kanera.app/mcp

服務執行狀況檢查是:

https://mcp.kanera.app/health

支援 OAuth 的客戶端可以直接新增 MCP 端點並在瀏覽器中完成身份驗證。使用 API 金鑰的客戶端將其作為載體令牌傳送:

Authorization: Bearer kanera_live_...

如果您的團隊在自己的地址執行Kanera,同樣 /mcp 以及 /health 複製下面顯示的確切 MCP 地址,然後將其複製到 配置檔案設定 -> API 金鑰 的那個Kanera。

協議版本

託管端點從同一伺服器同時服務於當前的 MCP 協議和 Claude、Codex、Cursor、Copilot、Gemini CLI 和 OpenCode 目前使用的早期版本。舊客戶端看到的工具、資源和提示與以前相同;使用當前協議的客戶端也會看到活動訂閱。兩者的工具模式都以相同的 JSON 模式方言釋出，因此客戶端不會看到不同的合約。 kanera mcp 對於 stdio 來說,它也同樣接受這兩種方式。

OAuth 令牌安全性

支援 OAuth 的客戶端會自動處理安全詳細資訊。為 Kanera 連線釋出的令牌僅適用於 Kanera 顯示的 MCP 地址;不能將其重用作為一般公共 API 憑據。

如果您正在構建自定義 OAuth 客戶端,請將該 MCP 地址作為 resource 下面的裝置授權示例顯示了它的所在位置。對於直接呼叫 REST API 的整合,請使用個人、工作區或板 API 金鑰。

針對 CLI 和無頭客戶端的裝置授權

無法接收瀏覽器重定向的客戶端（例如終端工具、SSH 會話或沒有可用瀏覽器的計算機）可以使用 OAuth 裝置授權授予 (RFC 8628) 進行連線。客戶端顯示一個簡短的程式碼，一個人在任何裝置上的瀏覽器中批准它，然後客戶端進行輪詢，直到收到令牌。

結果是與互動式 OAuth 相同的身份。該連線作為具有讀寫工具功能的批准使用者,而 Kanera 繼續在每個看板上強制執行該使用者的角色,從不獲得工作區管理訪問許可權。批准裝置請求需要允許代理連線的計劃,這與任何其他代理連線的要求相同。

Kanera 流量的增加 /.well-known/oauth-authorization-server:

後設資料欄位	價值
`device_authorization_endpoint`	`https://api.kanera.app/oauth/device/code`
`grant_types_supported`	包括 `urn:ietf:params:oauth:grant-type:device_code`

註冊裝置客戶端

註冊客戶端 /oauth/register 僅裝置客戶端不需要重定向 URI; redirect_uris 只有當客戶端也使用 authorization_code.

curl -X POST https://api.kanera.app/oauth/register \
  -H 'content-type: application/json' \
  -d '{
    "client_name": "Acme CLI",
    "grant_types": ["urn:ietf:params:oauth:grant-type:device_code", "refresh_token"]
  }'

Kanera 會拒絕未註冊裝置授權型別的任何客戶端的裝置流。

請求裝置程式碼

curl -X POST https://api.kanera.app/oauth/device/code \
  -d client_id=kanera_client_... \
  -d resource=https://mcp.kanera.app/mcp \
  -d 'scope=kanera:read kanera:write offline_access'

resource Kanera 將每個使用者授權的裝置請求正常化為一個 MCP 地址。 kanera:read kanera:write，包括省略的客戶 scope 當客戶端註冊了該請求時,Kanera 會發出一個重新整理令牌。 refresh_token 贈款型別； offline_access 接受但不要求。僅 kanera:read, kanera:write, 和 offline_access 接受。

回應欄位	意義
`device_code`	客戶端在調查時傳送回的秘密。
`user_code`	人型別的短程式碼,格式如下 `ABCD-2345`.
`verification_uri`	該 `/oauth/device` 您的Kanera網頁地址頁面。
`verification_uri_complete`	查詢字串中預填充了程式碼的同一頁面。
`expires_in`	`600`。該請求在發出十分鐘後就會過期。
`interval`	`5`。輪詢之間的最小秒數。

批准請求

客戶端顯示的 user_code 與 verification_uri，或開啟 verification_uri_complete 直接。
該人開啟該地址並登入到 Kanera(如果他們尚未登入 ) 。
該頁面給客戶端命名,顯示程式碼以便與終端進行對比,並列出客戶端將能夠執行的操作。
選擇 允許訪問 批准連線。選擇否定拒絕了。

令牌的投票

curl -X POST https://api.kanera.app/oauth/token \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=kanera_device_... \
  -d client_id=kanera_client_... \
  -d resource=https://mcp.kanera.app/mcp

投票不快於 interval。直到請求完成，令牌端點返回 400 標準的OAuth錯誤:

錯誤	意義	客戶應該做什麼
`authorization_pending`	尚未有人批准或拒絕該請求。	保持在當前間隔進行呼叫。
`slow_down`	客戶端的調查速度快於間隔。	Kanera 將增加5秒的間隔時間,從現在開始使用更長的間隔時間。
`access_denied`	該人拒絕了這一要求。	停止調查並啟動新請求。
`expired_token`	程式碼過期,或其令牌已發出。	開始一個新的請求。
`invalid_grant`	裝置程式碼未知或屬於另一個客戶端。	開始一個新的請求。

批准後，端點返回與其他每個授權相同的有效負載：受眾繫結 kanera_mcp_... 訪問令牌有效期為15分鐘,客戶端註冊時會有一個重新整理令牌。 refresh_token 裝置程式碼是一次性使用的,因此重複交換返回 expired_token。重新整理請求必須包含相同的內容 resource.

管理或撤銷裝置連線,在此處管理每個其他代理連線, 配置檔案設定 -> API 金鑰.

建立 API 金鑰

使用 API 金鑰來支援本地 stdio、僅接受靜態載體令牌的客戶端或自定義伺服器端整合。

個人 API 金鑰

開放 配置檔案設定.
去看看 API 鍵.
建立個人 API 金鑰。
選擇只讀或 閱讀和寫作。對於無人值守的代理來說，只讀是正確的預設設定：Kanera 拒絕 API 上的每個突變，因此客戶端的工具許可權並不是代理和您的工作之間的唯一障礙。與只讀金鑰連線的客戶端僅獲得讀取工具，因此它永遠不會計劃無法進行的更改。
新增一個可選的私人標籤來識別客戶。
當它顯示時,複製密碼。

個人金鑰有一個字首，例如 kanera_u_live_...。它顯示一次並充當其所有者，受您選擇的範圍限制。僅將其儲存在 AI 客戶端的憑證儲存或伺服器的秘密管理器中。

工作區或板 API 金鑰

開啟標準工作區或獨立看板。
去看看 設定 -> API.
建立 API 金鑰。
選擇適合工作流程的最小範圍。
當它顯示時,複製密碼。

範圍	贈款
閱讀	檢查、搜尋、總結和報告,而不需要更改 Kanera。
寫	建立和更新白板內容,包括卡片、清單、評論、任務、標籤、自定義欄位值和註釋。
管理員	執行支援的直接公共 API 管理。預設 MCP 伺服器保持工作重點,不會公開任何工作區、板、列表、標籤、欄位、選項、保留或訂單管理工具。

連線本地 stdio 客戶端

下面是最簡單的本地 stdio 伺服器: Kanera CLI。安裝它，登入一次，然後將客戶端指向 kanera mcp;它使用儲存的憑據在 stdio 上提供相同的工具層，因此無需在第二個位置配置第二個金鑰。

npm install --global @kanera/cli
kanera auth login

{
  "mcpServers": {
    "kanera": {
      "command": "kanera",
      "args": ["mcp"]
    }
  }
}

使用 npx @kanera/cli mcp 當你不想安裝任何東西時,請使用全域性安裝,並新增 "args": ["mcp", "--profile", "agent"] 選擇一個命名的配置檔案。

要透過環境而不是儲存的配置檔案(CI 或沙盒代理中的通常選擇)提供憑據,CLI 和獨立 MCP 包都會顯示:

環境變數	目的
`KANERA_API_KEY`	個人、工作區或板 API 金鑰。
`KANERA_PUBLIC_API_URL`	Kanera 公共 API 源,如 `https://api.kanera.app`.

{
  "mcpServers": {
    "kanera": {
      "command": "npx",
      "args": ["-y", "@kanera/cli", "mcp"],
      "env": {
        "KANERA_API_KEY": "kanera_u_live_...",
        "KANERA_PUBLIC_API_URL": "https://api.kanera.app"
      }
    }
  }
}

當您根本不需要在本地執行 MCP 程序時,請使用託管 HTTP 端點。

資源

Kanera 提供四種結構化 JSON 資源模板:

資源	URI	含有
標準工作區	`kanera://workspace/{workspaceId}`	憑證可見的有界工作區配置和共享列表、標籤、欄位、模板、自動化和成員資格
看板	`kanera://board/{boardId}`	標準工作區或獨立板的有界後設資料和可見配置，無卡
卡片	`kanera://card/{cardId}`	卡片詳細資訊，包括標籤、受讓人、清單、附件和連結註釋
備註	`kanera://note/{noteId}`	可見的個人或團隊筆記

個人筆記對於已連線使用者是私密的,不要暗示其他工作區成員或工作區服務憑據可以閱讀它們。

卡片參考

命名的 MCP 卡欄位 cardId 或 cardIds 接受以下任何參考:

人類卡片鑰匙，例如 PROJ-123，包括使用先前工作區字首的精確鍵。
規範的 Kanera 卡 URL。
公共 API 返回的卡片 UUID。

在提示和麵向使用者的回覆中使用人類金鑰。 Kanera 會在呼叫現有公共 API 操作之前將其解析為 UUID,因此授權、Activity 和稽核行為保持不變。解析後的金鑰會在連線中儲存幾分鐘,因此在多步任務中重複使用該金鑰不會重複查詢。

卡結果包括當前人類可讀的金鑰。的 kanera://card/{cardId} 資源 URI 繼續使用 UUID;人類鍵和連結適用於 MCP 工具輸入。

能力組

實時工具模式是名稱、輸入、安全註釋和限制的權威。伺服器目前涵蓋:

面積	可用操作
發現	檢查代理會話、頁面標準工作區和可訪問的看板、讀取限制工作區或看板配置以及頁面看板和成員
配置邊界	讀取目標工作所需的列表、標籤、欄位、選項、成員和許可權。建立、編輯、重新排序、保留和其他列表/工作區管理操作仍保留在 Kanera 介面中,而不是 MCP 工具
搜尋	搜尋實時卡片、筆記、評論和附件檔名,或搜尋官方的 Kanera 文件
卡片	閱讀摘要或完整內容,為多達 200 張選定卡片檢索限制清單/註釋內容,建立、更新、移動、重新排序、複製、在相容板之間移動,存檔、解除存檔、完成、重新開啟和管理附件和封面
卡牌關係	用以下方法讀取單個連結 `cards.get`，探索鏈 `cards.dependency_graph`，並新增或刪除 `blocks`, `blocked_by`, 或 `relates_to` 與 `cards.set_relations`
附件	使用 `cards.get_attachment` （影象作為影象，文字檔案作為分頁文字）；從代理自己的磁碟附加一個檔案 `cards.create_upload_link`，它返回代理上傳到的一次性 URL `curl -T`
板隔板	建立標題、可選顏色分隔符;更新其外觀;相對於卡片、分隔符或列表邊緣移動它們;相對於分隔符放置卡片;刪除分隔符而不更改卡片
批次卡工作	在選定的卡片上完成、日期、標籤、分配、移動、存檔、複製或設定自定義欄位,並在每個方案中公開板級批次限制
作業和欄位	替換分配者或標籤,並設定或清除支援的自定義欄位值
評論意見	頁面,新增可選附件,編輯,刪除合格的評論,並同時新增或刪除反應
檢查清單	將卡片的清單作為巢狀樹讀取,並附帶 ID;在一個原子呼叫中建立一個清單,其中包括專案、分配人、到期日期和一個級別的子清單;在選定位置新增一個或多個專案;更新一個或多個專案,每個專案有不同的更改;為每個專案設定一個分配人或到期日期;重新命名、重新排序、移動和刪除。
下一個優先事項	發現可讀的個人和團隊佇列,讀取確切的排名順序,並在憑據和工作區許可權允許時新增、移動或刪除分配的活動卡片
代理執行	在卡片上宣佈飛行中的工作 `runs.start`，報告進度和心跳 `runs.update`，以終端狀態關閉執行，並檢查已經執行的內容 `runs.list`
工作和報告	查詢帶有逾期、未分配、不活動和最後移動過濾器的限制個人或可見團隊卡片;透過 `work.my_day`;檢查時間線計劃和跨板彙總 `work.portfolio_summary`;並在可訪問的板上生成個人站立證據
活動和完成的工作	頁面板活動和卡片歷史記錄,並閱讀完成歷史記錄和工作完成記錄
筆記	頁面筆記後設資料,閱讀完整內容,建立、更新、連結、附加小檔案,複製和重新排序個人或團隊筆記
便箋	將“提醒我……”專案捕獲到您的私人空間便箋無需選擇論壇即可檢視收件箱,列出和閱讀頁面,並勾選專案。需要瀏覽器登入或個人金鑰

見下文第10段。生成 MCP 工具庫存對於每個註冊的工具名稱。

卡牌關係

cards.get 包括卡的 relations 以及 hiddenBlockerCount. cards.set_relations 新增或刪除同一工作區中的關係:

{
  "cardId": "WEB-18",
  "direction": "blocked_by",
  "otherCardIds": ["MKT-42", "MKT-43"],
  "remove": false
}

direction 是 blocks, blocked_by, 或 relates_to, 讀取自 cardId的一邊。 otherCardIds 接受一張或多達50張卡片參考; remove 新增是同權的,並且按目標提交。部分成功返回 failed 條目和任何 notAttemptedCardIds 如果最終讀取失敗,則返回原始資料。 addedCardIds 以及 relationsUnavailable 當每次嘗試更改都被拒絕時,呼叫會出錯。刪除提交也會按照目標進行: removedCardIds 保留成功的移除與任何 failed, notAttemptedCardIds, 或 relationsUnavailable 詳情。 notFoundCardIds 命名它無法看到或找到的關係;這些關係將被單獨留下。

可寫入的憑證需要編輯訪問許可權 cardId 讀取會刪除無法訪問的卡片詳細資訊,但會計算隱藏的活動卡片。使用讀取會刪除無法訪問的卡片詳細資訊,但會計算隱藏的活動卡片。 filters: { blockedOnly: true } 與 work.query_cards 對於被封閉的公開牌,或 atRiskOnly: true 對於其可見的阻止器已過期或到期後的開放卡; work.portfolio_summary 訂閱我們的新聞通訊 card.blocked 以及 card.unblocked 這些事件獨立於配置的自動化進行工作。

透過 MCP 完成操作不會顯示互動式的工作受阻警告。判斷工作是否已就緒時，應先讀取關聯關係。處於受阻狀態的代理執行（runs.update 與 status: "blocked"）描述了執行並且不會建立卡依賴性。參見卡片關係與阻塞.

依賴圖

cards.dependency_graph 說明哪些工作阻塞了卡片、卡片阻塞了哪些工作，以及看板或工作區內有哪些相關工作。以下引數必須且只能傳入一個： cardId （金鑰、UUID 或規範 URL）， boardId, 或 workspaceId:

{ "cardId": "MKT-42" }

工具返回擴充套件 cards, edges, 和 truncated。卡片包括其金鑰、標題、URL、來源板/列表名稱、 inScope，以及可用日期、標籤和受讓人。 openBlockerCount 包括呼叫者看不到的活動阻止器; offMapBlockerCount 計算此對映中缺少的活動阻塞器。僅包含現有非零可選值。 A blocks 邊緣執行從 sourceCardId 至 targetCardId.

卡範圍也返回 focus: blockedBy 以及 blocks 是直接連線; upstream 以及 downstream 是最接近第一序列的可傳遞卡片 ID; relatedTo 列出上下文連結。 onMap: false 表示請求的卡片已完成、存檔、無關聯或以其他方式從圖中缺失。缺失並不證明卡片沒有關係。

圖形跟隨可讀的開放卡片的雙向阻塞連結。完成的先決條件可以出現,但不會透過它們繼續穿越。隱藏的卡片被計數,但不被命名或用於連線到其他工作。 truncated;縮小範圍以獲得更多細節。這是一個閱讀工具。使用 cards.set_relations 編輯連結和依賴事件監控變化。

日期

日期輸入接受 YYYY-MM-DD 或者日常短語,在您自己的時區從您的Kanera配置檔案解決: today, tomorrow 1pm, friday （下週五，包括今天）， next friday （一週後）， in 2 weeks, next month, end of week, end of month, 或 oct 12. session.get 返回你的 timeZone 以及 today Kanera 的到期日使用時間間隔而不是確切的時間,所以時間會選擇匹配的時間間隔: 到 09:00 是 12:00, 13:00 是 16:00, 17:00 是 20:00, 21:00 是 22:00, 23:00 是 24:00。上午，截至 13:00 下午，截至 17:00 工作日結束，以及之後的全天時段。無法讀取的短語 Kanera 會被接受的形式拒絕，而不是猜測。

結果順序

每個列表工具的描述都會說明其結果的顯示順序,例如對於評論和活動來說是"最新的先顯示 ", 對於列表和清單來說是顯示順序,對於 work.query_cards 預設情況下。

時間表和開始日期

使用 work.schedule 與正好一個 boardId 或 workspaceId。它讀取與相同的工作日引擎時間軸檢視，遵循跨棋盤可訪問的連線鏈，並排除已完成和不可訪問的卡。顯示過濾器不會改變計算。

結果	意義
`cards[].plannedStart`, `plannedEnd`, `durationDays`	計劃的日期範圍及其週一至週五的持續時間。
`earliestStart`, `earliestFinish`, `latestStart`, `latestFinish`	受依賴關係約束的日期和保留鏈結束的最後日期。
`slackDays`, `critical`	工作日的延遲空間,以及連線的工作是否沒有延遲。零延遲意味著計算沒有日期錨點。
`conflicts[]`	衝突的開放阻塞器,與 `blockerId`, `edgeId`, `kind`，以及工作日 `days`.
`criticalEdgeIds`	排程關鍵路徑上的關係。
`summary`	排定/未排定、衝突和臨界點數、日期範圍、 `projectedFinish`, `latestDue`，以及工作日 `slipDays` 對照最後到期日。

透過 startDateLocalDate 至 cards.create, cards.update 內部 changes，或每個條目 cards.bulk_create。使用 YYYY-MM-DD 或在使用者區域中解析的支援的相對日期短語; null 清除現有開始。開始沒有時間間隔,不能超過到期日期。這些寫入需要編輯許可權,並且不會自動移動繼任日期。

沒有假設的時間表輸入:從當前時間表提出更改,然後僅在打算儲存更改時應用並重新讀取。參見工作規劃示例以及排程事件有效載荷。禁用規劃功能迴歸 TIMELINE_DISABLED 或 DEPENDENCIES_DISABLED 對於需要它們的操作。

活動訂閱

當前MCP協議上的客戶端可以訂閱 card.created, card.updated, card.moved, 和 comment.created 工作區、板或卡片中,以便 priorities.changed 下一佇列,並將其新增到已連線使用者的下一佇列中。 my_day.ready 訂閱屬於連線,每次重新整理持續時間最長為 24 小時,並且在每次交付之前都會根據身份的當前訪問許可權重新檢查。參見訂閱事件用於目錄、驗證、簽名、重試和錯誤程式碼。

內建提示

提示符	使用
`summarize_board_status`	檢查一個看板並總結進度、阻礙因素、陳舊工作和下一步行動。
`prepare_standup_update`	將個人當前工作和分頁工作歷史記錄結合在無障礙板上,以草擬一份立場檔案。
`draft_card_from_notes`	閱讀筆記並草擬卡片標題和 Markdown 描述,而無需建立卡片。

即使 AI 客戶端不公開 MCP 提示模板,正常的對話提示也會正常工作。

安全和破壞性行動

互動式和裝置程式碼 OAuth 始終授權 kanera:read 以及 kanera:write; offline_access MCP 客戶端控制工具的可用性和審批,而 Kanera 則強制執行板角色。管理工具僅在使用者擁有相應的管理員角色時才能執行:組織管理員可以建立工作區和獨立板,工作區管理員可以新增板和管理自動化。
每個 OAuth 流都將其授權、程式碼、重新整理系列和訪問令牌繫結到規範 MCP resource.
原始 kanera_mcp_... 訪問令牌僅被 MCP 端點接受,並被 /api/v1; MCP 服務對公共 API 呼叫使用單獨的分鐘生存期內部委派憑證。
裝置授權使用相同的範圍和限制,裝置程式碼在 10 分鐘後過期,可交換一次,並且只有登入使用者確認客戶端顯示的程式碼才能批准。
無人值守代理和工作區金鑰的上限為其配置的作用域。
私鑰繼承其所有者的當前許可權,並且應該像使用者帳戶一樣受到保護。
讀取作用域 API 金鑰和無人值守服務憑據不能呼叫受保護的變異。
API-key 和 MCP 活動與其代理使用者或整合身份一起記錄。互動式 OAuth 代理被記錄為代表其使用者的代理：註釋和活動行攜帶代理的名稱並呈現為 via <agent>，並且使用者會收到關於他們的代理做了什麼的通知，而不是將其作為自己的操作進行抑制。指令碼使用的個人 API 金鑰仍充當其所有者。
斷開 OAuth 連線或刪除無人值守代理將撤銷其活動憑據。
每個客戶端使用單獨的憑據,以便在撤銷一個連線時不影響另一個連線。

Kanera MCP 無法刪除:

看板
列表
標籤或自定義欄位
筆記
附錄

刪除那些手動 Kanera. MCP 可以存檔或取消存檔卡片,並且可以存檔列表中的活動卡片。

MCP 的管理僅限於建立工作區和獨立板（組織管理員，使用互動式 OAuth 授權或可寫入的個人金鑰）、向工作區新增板以及建立、編輯、啟用和刪除自動化（工作區管理員）。 MCP 無法編輯、重新排序或刪除工作區、看板、列表、標籤、欄位、選項、成員或保留設定。這些操作仍保留在 Kanera 介面中；支援的 REST 端點仍然可用於有意構建的整合。

MCP 可以永久刪除:

由代理使用者撰寫的評論
清單及其專案
清單專案

這些工具模式被標記為破壞性的,只有在明確請求後才使用,並且在呼叫之前驗證目標。

故障排除

問題	要檢查什麼
客戶端無法連線	使用精確的 `/mcp` 您正在連線的 Kanera 的 URL,如下所示配置檔案設定 -> API 金鑰.
客戶端請求令牌而不是開啟 Kanera	它不支援遠端 MCP OAuth。請使用 API 金鑰或受支援的客戶端。
您的瀏覽器沒有自動跳轉,請點選這裡	使用裝置授權如果客戶端支援,則提供一個 API 金鑰。
投票不斷回來 `slow_down`	比較快的調查 `interval` 返回的裝置程式碼,並在每個 `slow_down`.
裝置頁面報告無效或過期程式碼	程式碼有效期為 10 分鐘,只能使用一次。檢查程式碼,先登入,然後向客戶端請求新程式碼。
標記端點返回 `invalid_target`	從哪裡傳送確切的 MCP 地址配置檔案設定 -> API 金鑰作為 `resource` 在授權和每次令牌交換期間。
報告缺少 API 金鑰	集合 `KANERA_API_KEY` 為 stdio 或傳送 `Authorization: Bearer ...` 透過 HTTP 傳輸。
請求返回 `401`	憑據丟失、形式不正確、過期、已撤銷或複製不正確。重新啟動 OAuth 或更換 API 金鑰。
請求返回 `403`	對於個人 OAuth,請確認代理使用者是目標板上的編輯者而非觀察者。對於 API 金鑰或無人值守代理,還請確認憑據具有寫入功能。
代理可以讀取但不能編輯	允許 MCP 客戶端中的寫入操作，並確認代理身份具有板編輯器訪問許可權。對於服務連線和 API 金鑰，還可以使用可寫入的憑據。現有個人 OAuth 連線不需要重新連線。
代理無法找到一個板	看板可能是獨立的,也可能僅透過明確的訪客會員身份才可訪問。
代理無法管理工作區	MCP 僅涵蓋建立工作區和看板以及管理自動化,並且僅適用於代理身份為管理員的情況;工作區範圍和只讀憑據無法建立工作區。對於其他管理,請使用 Kanera 介面或支援的公共 REST 端點。
編碼代理有工具，但使用它們很差	安裝官方 Kanera 特工技能.
新工具或更改的工具不會顯示	重新整理或重新掃描客戶端中的 MCP 伺服器,以便其檢索當前的架構。如果客戶端沒有重新整理操作,請重新啟動客戶端;通常不需要 OAuth 重新授權。
客戶端無法訂閱事件	需要幫助的朋友 `/mcp` 一個客戶端和一個伺服器,在當前的MCP協議上; `kanera mcp` 伺服器從不提供它們。訂閱事件回撥和作用域錯誤。

連線方法​

託管端點​

協議版本​

OAuth 令牌安全性​

針對 CLI 和無頭客戶端的裝置授權​

註冊裝置客戶端​

請求裝置程式碼​

批准請求​

令牌的投票​

建立 API 金鑰​

個人 API 金鑰​

工作區或板 API 金鑰​

連線本地 stdio 客戶端​

資源​

卡片參考​

能力組​

卡牌關係​

依賴圖​

日期​

結果順序​

時間表和開始日期​

活動訂閱​

內建提示​

安全和破壞性行動​

故障排除​

相關頁面​