tennnzo說明文件

更多

個人 API 金鑰

每位成員都能在個人設定的「我的 API 金鑰」建立自己的金鑰，把 AI 助理或工具接上 tennnzo。說明金鑰代表誰、怎麼建立與撤銷、各角色能做的事，以及 MCP 與 API 位址。

個人 API 金鑰讓你把自己的 AI 助理或工具接上 tennnzo，用講的查待審稿、做審稿決定、讀報告。這頁說明金鑰是什麼、怎麼建立和撤銷，以及你的角色用金鑰能做哪些事。

金鑰代表你本人#

個人金鑰的開頭是 tnu_。它不是另一個帳號，而是你本人：

  • 看得到的、能做的，和你在畫面上點按鈕完全一樣。
  • 審稿紀錄上記的名字是你。
  • 能做什麼由你目前在這個組織的角色決定，每次請求都重新計算。角色被調整，下一次請求就跟著變。
  • 離開這個組織，金鑰立刻失效。
  • 一把金鑰只屬於建立它的那個組織。
  • 個人金鑰在組織層級運作，不分工作區，也不受畫面上選的工作區影響。你在組織裡看得到的，金鑰都看得到。

Agent 用的是另一種金鑰，每把屬於一個工作區，見 Agent 金鑰。兩者互不影響。

建立金鑰#

  1. 點左下角你的名字打開帳號選單，選「個人設定」，再切到「我的 API 金鑰」（網址是 /me/keys）。舊網址 /account/keys 會自動轉到這裡。
  2. 在「建立金鑰」區塊的「名稱」填一個認得出用途的名字，例如「我的 Claude 助理」（80 字內）。
  3. 按「建立金鑰」。
  4. 畫面會出現「新金鑰（只顯示這一次）」，按「複製」，馬上貼到你的工具設定裡。

重要 完整金鑰只顯示這一次。離開或重新整理頁面後就看不到了，tennnzo 也沒有保存可以還原的副本。弄丟了就撤銷再建一把。不要把金鑰貼在群組或對話裡。

每人在同一個組織最多有 10 把有效金鑰。滿了會看到「同一個組織最多 10 把有效金鑰，請先撤銷一把。」

還沒完成 首次登入設定 的帳號不能建立、也不能使用金鑰。示範組織不能建立金鑰。

管理與撤銷#

「我的金鑰」表格列出你建立過的金鑰：「名稱」「金鑰開頭」「建立」「最後使用」。

按「撤銷」並確認後，這把金鑰立即失效，無法恢復；表格上會改成「已撤銷」和撤銷時間。用這把金鑰拿到的圖片連結也會立刻打不開。

組織管理者可以在組織設定的「Agent 與金鑰」分頁看到所有成員的個人金鑰並撤銷，但看不到金鑰本身，見 Agent 金鑰。

你的角色能做的事#

「我的 API 金鑰」頁上的「你的角色」區塊，會列出你目前用金鑰可以做的事。完整對照如下：

能做的事客戶Agency平台管理員
看自己的身分、組織與專案可以可以可以
看審稿佇列只有待客戶審稿全部階段全部階段
看單篇貼文與相關脈絡可以可以可以
審稿（通過、要求修改、退回）要有審稿權可以，另可送審與排程可以，另可送審與排程
看已發布的貼文可以可以可以
看報告、讀一份報告只有發布給客戶的全部全部
看待裁決、裁決（已處理／不處理）、回答待裁決的選項題不行可以可以
看 Agent 看板、交辦新任務給 Agent、確認 Agent 完成的任務、退回 Agent 重做不行可以可以
看今日摘要不行可以可以
看成效數字不行可以可以
看這個組織所有金鑰不行不行可以
撤銷任何人或 Agent 的金鑰不行不行可以

客戶的審稿動作和畫面上一樣：通過、要求修改、退回、要求 Agent 重寫，後三者要附意見，而且只能在「待客戶審稿」、專案開著客戶審稿時做。沒有審稿權的客戶，頁面上會顯示「你目前沒有審稿權限，所以不能用金鑰做審稿決定（只能看）。」

規則和畫面按鈕一致。例如客戶審稿開著時，Agency 用金鑰也不能替客戶通過。

怎麼接#

所有請求都在標頭帶上金鑰：

text
Authorization: Bearer tnu_xxxxxxxx_…
方式位址
MCPhttps://api.tennnzo.com/api/mcp
APIhttps://api.tennnzo.com/api/user/v1 開頭

支援遠端 MCP 的助理，新增一個 HTTP MCP 伺服器、填上 MCP 位址並加上同樣的 Authorization 標頭即可。MCP 只會列出你的角色能用的工具。

金鑰只放在你自己電腦的設定裡。接好之後可以這樣說：

  • 客戶：「有哪些貼文等我審？」「這篇通過。」「上週的週報重點是什麼？」
  • Agency：「今天有什麼要處理？」「把 TW-T014 那篇排在明天晚上 8 點。」
  • 平台管理員：「這個組織有哪些金鑰？」

建議讓助理在做審稿決定或撤銷金鑰前先跟你確認，因為這些動作會用你的名字記錄，撤銷也無法恢復。

圖片連結#

透過金鑰拿到的貼文配圖連結，15 分鐘內有效，不用帶金鑰就能打開。過期後重新查一次那篇貼文或審稿佇列，就會拿到新的連結。

用量限制#

每把金鑰預設每分鐘最多 60 次請求。超過時會收到 rate_limited 錯誤，等回應裡註明的秒數後再試。

每次請求都會留下紀錄：誰、哪把金鑰、做了什麼、結果，不記內容。

更多說明#