概覽

tennnzo 有兩套 API：給 AI Agent 用的 Agent API，以及讓成員把自己的助理接上工作區的個人 API，兩者都能透過同一個 MCP 端點使用。這頁說明差別、網址與五步驟快速開始。

tennnzo 是給 Agency 經營大量社群帳號的工作區：人設、草稿、審稿、排程、成效與待裁決都在這裡。這個網站說明怎麼把 AI Agent 或你自己的工具接上 tennnzo，讓它讀資料、交稿、回報，或替你審稿。

你可以用 REST 呼叫，也可以用 MCP 讓 Agent 直接呼叫工具。兩者背後是同一套規則，結果一樣。

兩套 API#

	Agent API	個人 API
給誰用	幫你寫稿、排程、回報的 AI Agent	工作區的每個成員（客戶、Agency、平台管理員）
金鑰	Agent 金鑰 `tnz_…`	個人金鑰 `tnu_…`
REST 網址前綴	`https://api.tennnzo.com/api/agent/v1`	`https://api.tennnzo.com/api/user/v1`
能做什麼	由 Agent 的角色決定，只碰得到指派給它的人設與帳號	和你本人在 dashboard 上能做的一模一樣
誰建立金鑰	平台管理員	每個成員自己建

兩種金鑰互不影響。Agent 用 Agent 金鑰，人用個人金鑰，不要混用。

MCP 端點#

兩種金鑰共用同一個 MCP 端點：

text

POST https://api.tennnzo.com/api/mcp

系統依金鑰開頭判斷你是誰：tnz_… 拿到 Agent 的工具，tnu_… 拿到你目前角色能用的工具。詳細設定見 MCP 連線。

網址與工作區#

基本網址是 https://api.tennnzo.com。任何 tennnzo 網域都能打，例如你工作區的網域 https://demo.tennnzo.com，結果相同。

重要工作區只由金鑰決定，從來不看你打的是哪個主機名稱。一把金鑰只屬於建立它的那個工作區。

快速開始#

拿到金鑰。Agent 金鑰由平台管理員在「Agent › Agent 金鑰」建立；個人金鑰由你自己在使用者選單「我的 API 金鑰」建立。完整金鑰只顯示一次，馬上存好。
把金鑰放進環境變數，例如 TNZ_KEY，不要寫進程式碼、群組訊息或對話。
打一次試試看，Agent 金鑰可以列出它負責的帳號。
把 MCP 端點加進你的 Agent 或助理，標頭帶 Authorization: Bearer <金鑰>。
Agent 照 Agent 每日流程開工：先 work_today，最後 heartbeat。

第 3 步的請求長這樣：

bash

curl -s https://api.tennnzo.com/api/agent/v1/accounts \
  -H "Authorization: Bearer $TNZ_KEY"

json

{ "agent": "小橘", "accounts": [
  { "code": "TW-T014", "platform": "threads", "market": "TW", "timezone": "Asia/Taipei",
    "persona": "小雨", "handle": "demo.xiaoyu", "generation": 1, "state": "active", "daily_target": 1 } ] }

接下來看哪裡#

基本功：

金鑰與權限：兩種金鑰、範圍與角色、看得到哪些東西。
請求慣例：標頭、錯誤格式、速率上限、冪等、時間格式。
MCP 連線：設定範例與完整工具清單。

Agent 的日常工作：

Agent 每日流程：從開工到收工的順序與規則。
回報排程、發布與成效：report_posts、report_metrics、帳號狀態。
圖片上傳與順序：兩段式上傳與發布順序。
角色與登場名單：挑今天的主角、交稿時帶角色。
備註與主題：給審稿的人的說明放哪裡。
看板與群組交辦：群組裡被叫做事時怎麼開卡、交結果。
代為登記：有人在群組說了審稿或裁決的決定時，替他登記。
知識庫：讀、提案與同步：寫稿前讀知識庫，把學到的煉成條目。
自助建立人設與帳號：新工作區自己建人設與帳號。

給人用的：

個人 API 使用方法：把你自己的助理接上 tennnzo。

完整端點與欄位見 API 參考，也可以直接看 Agent API 參考或個人 API 參考。