三步開始
- 產生金鑰
- 貼到 AI
- 開始對話
1. 產生金鑰：到 設定 › API 與 AI 連線 按「產生金鑰」，取個好認的名字（例如「Claude 助理」），勾選它可以做的事。金鑰只會顯示一次，請馬上複製。
2. 貼到 AI：照下面各家的步驟把網址或金鑰貼進去。
3. 開始對話：例如「今天有什麼要處理？」「幫我查王小美設計的聯絡電話」「新增客戶：好日子設計，統編 12345675，窗口林小姐」「幫好日子設計開一張網站維護 3 個月、每月 1800 元的報價草稿」。
接到各家 AI
接到 Claude
Claude 網頁版、桌面版、ChatGPT 的「連接器」：這類連接器只能填網址、要用 OAuth 登入，目前還不支援（為了安全，不提供網址帶金鑰的接法）。請先用下面支援標頭的工具。
Claude Code（終端機）：執行一次這行，金鑰放在標頭、不會出現在網址
claude mcp add --transport http hj-eip https://hj-eip.lgscvbatter.workers.dev/api/mcp --header "Authorization: Bearer hjk_你的金鑰"
Cursor、VS Code 與其他支援 MCP 的工具
設定檔（通常叫 mcp.json）加入下面這段。金鑰放在標頭，比放網址安全。
{
"mcpServers": {
"hj-eip": {
"url": "https://hj-eip.lgscvbatter.workers.dev/api/mcp",
"headers": {
"Authorization": "Bearer hjk_你的金鑰"
}
}
}
}自己寫程式、n8n、Make、Zapier：直接呼叫 REST API，例如查今天要處理的事
curl -H "Authorization: Bearer hjk_你的金鑰" https://hj-eip.lgscvbatter.workers.dev/api/v1/todo
AI 可以做的事（MCP 工具）
MCP 網址：https://hj-eip.lgscvbatter.workers.dev/api/mcp（Streamable HTTP，金鑰放 Authorization: Bearer 標頭；不接受網址帶金鑰）。AI 只看得到這把金鑰能用的工具。
| 工具 | 做什麼 | 需要的功能 |
|---|---|---|
| whoami | 金鑰資訊 查這把 API 金鑰的名稱、代表的帳號、可用功能與今天的呼叫次數。不確定能做什麼時先呼叫這個。 | 每把金鑰都能用 |
| get_company | 讀公司資料 讀自己公司的基本資料：名稱、統編、負責人、地址、電話、Email、收款銀行帳戶。寫信、填表、開報價時要帶公司資訊就用這個。 | 讀公司資料 |
| search_customers | 列出／搜尋客戶 列出客戶，可用關鍵字搜尋名稱、聯絡人、統編、電話、Email，或用標籤篩選。回傳每位客戶的聯絡資料與往來摘要（累計成交、待收款、下次跟進）。找特定客戶的 id 也用這個。 | 查客戶 |
| get_customer | 查單一客戶 用客戶 id 查完整資料：聯絡資料、往來摘要（累計成交、已收、待收、逾期）、最近 10 張單據、未完成的跟進提醒、最近 5 筆往來紀錄。 | 查客戶 |
| create_customer | 新增客戶 建立一位新客戶（寫進「客戶」工具，報價、合約、發票共用）。有統編時會檢查重複：同統編已存在會回錯誤並附上既有客戶 id。建立前若不確定是否已有這位客戶，先用 search_customers 查。 | 新增、修改客戶 寫入 |
| update_customer | 修改客戶 更新客戶資料：只改有給的欄位，沒給的維持原樣；給空字串代表清空該欄（名稱不能清空）。標籤（tags）給的是完整清單，會整個取代。 | 新增、修改客戶 寫入 |
| list_quotes | 列出報價收款單據 列出報價單、請款單、收據（預設只列報價單；kind=all 全部）。可依狀態、客戶、單號／客戶名關鍵字篩選。回傳金額（含稅合計、已收、未收）、是否過期／逾期與單據連結。 | 查報價收款單據 |
| get_quote | 查單一單據 用 id 或單號（例如 Q20261019-0001）查一張報價單／請款單／收據的完整內容：客戶、品項、稅額、合計、收款狀態、備註條款。 | 查報價收款單據 |
| create_quote_draft | 建立報價草稿 幫客戶開一張報價單「草稿」（自動編號、有效期限照報價收款設定）。客戶要先存在：給 customer_id，或給 customer_name（必須和既有客戶名稱完全相同）；沒有這位客戶就先用 create_customer。草稿不會寄給客戶，請提醒使用者到回傳的連結確認後再發送。 | 建立報價草稿 寫入 |
| search_knowledge | 查公司知識庫 用關鍵字查公司知識庫（營業時間、服務項目與價格、常見問答、公司規定…）。回答客戶問題或寫文案前，先查這裡確認公司的正確說法。 | 查公司知識庫 |
| kb_search | 查法規知識庫 查 Hour Jungle 法規知識庫（台灣公司設立、借址登記、營業稅、營所稅、扣繳、發票、勞健保、二代健保、特許行業、政府補助與相關法條的白話整理）。回答稅務、會計、公司登記、勞健保規定的問題前先查這裡，回覆時附上 url 讓使用者核對原文；知識庫沒有的不要自己編數字或期限。回傳每篇的標題、命中段落、摘要與網址，要全文再用 kb_get_note。 | 每把金鑰都能用 |
| kb_get_note | 讀法規知識庫全文 讀法規知識庫的一篇全文（Markdown）。slug 用 kb_search 回傳的 slug，也可以直接給篇名，例如「營業稅法」「租金扣繳與二代健保」。很長的篇會分段回傳，用 offset 讀下一段。 | 每把金鑰都能用 |
| list_todos | 今天要處理 列出公司今天要處理的事（跟首頁「今天要處理」同一份）：逾期待收款、客戶已接受待轉單的報價、待簽合約、待核准請假、LINE 待確認草稿、過期的客戶跟進。依急迫程度排序，每項附連結。 | 看今天要處理 |
| list_calendar_events | 看行程 列出一段期間的行程（跟首頁「近期行程」同一份）：排班、請假、合約到期、客戶跟進、收款與報價期限、發薪日。預設今天起 14 天，最多 92 天。 | 看行程 |
REST API（自己寫程式、n8n、Make、Zapier）
每個請求帶 Authorization: Bearer hjk_…；回傳 JSON，成功是 { "data": … }，列表另有 total／limit／offset；失敗是 { "error": { "code", "message" } }。日期一律 YYYY-MM-DD（台灣時間），金額單位新台幣元。
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /api/v1/me | 金鑰名稱、可用功能、今天用量 |
| GET | /api/v1/company | 公司資料 |
| GET | /api/v1/customers?q=&tag=&limit=&offset= | 列出／搜尋客戶 |
| GET | /api/v1/customers/{id} | 單一客戶（含往來摘要、單據、跟進） |
| POST | /api/v1/customers | 新增客戶 |
| PATCH | /api/v1/customers/{id} | 修改客戶（只改有給的欄位） |
| GET | /api/v1/quotes?kind=&status=&customer_id=&q= | 列出報價／請款／收據 |
| GET | /api/v1/quotes/{id 或單號} | 單一單據（含品項、收款） |
| POST | /api/v1/quotes | 建立報價草稿 |
| GET | /api/v1/kb?q= | 查公司知識庫 |
| GET | /api/v1/legal-kb?q= | 查法規知識庫（稅務、公司設立、勞健保、法規） |
| GET | /api/v1/legal-kb/{slug 或篇名} | 讀法規知識庫一篇全文 |
| GET | /api/v1/todo | 今天要處理 |
| GET | /api/v1/calendar?from=&to=&kind= | 行程 |
範例：新增客戶
curl -X POST https://hj-eip.lgscvbatter.workers.dev/api/v1/customers \
-H "Authorization: Bearer hjk_你的金鑰" -H "Content-Type: application/json" \
-d '{"name":"好日子設計有限公司","tax_id":"12345675","contact_name":"林小姐","phone":"02-2345-6789"}'範例：建立報價草稿（客戶要先存在）
curl -X POST https://hj-eip.lgscvbatter.workers.dev/api/v1/quotes \
-H "Authorization: Bearer hjk_你的金鑰" -H "Content-Type: application/json" \
-d '{"customer_name":"好日子設計有限公司","items":[{"name":"網站維護","unit":"月","qty":3,"unit_price":1800}],"note":"簽約後三日內付清。"}'欄位說明
客戶：name（必填）、tax_id（8 碼，不可重複）、owner_name 負責人、contact_name 聯絡人、phone、email、address、tags（陣列或逗號分隔）、note。修改時只送要改的欄位；送空字串會清空該欄。
報價草稿：customer_id 或 customer_name（完全相同的既有客戶名稱）、items（name、unit_price 必填；qty 預設 1、unit、taxable 預設 true）、issue_date 預設今天、valid_until 預設照「報價收款」設定的有效天數、tax_mode（excl 未稅另加 5%／incl 已含稅／none 免稅，預設照設定）、note。只會建立草稿，寄出前請到回傳的 url 確認。
行程：from、to（含）預設今天起 14 天，最多 92 天；kind 可選 shift、leave、contract_expiry、followup、payday、quote_due。
權限、上限與紀錄
金鑰權限＝帳號權限：每把金鑰代表公司裡的一個帳號。帳號停用、工具權限被拿掉，金鑰立刻跟著失效或縮小，不用另外改。另外可以在金鑰上只勾部分功能，例如給客服 AI 只開「查公司知識庫」。
- 讀公司資料
- 公司名稱、統編、負責人、地址、電話、收款帳戶。
- 查客戶
- 列出、搜尋客戶，看單一客戶的聯絡資料、往來摘要、待收款。帳號要有「客戶」工具權限。
- 新增、修改客戶 寫入
- 建立新客戶、更新聯絡資料。不能刪除客戶。帳號要有「客戶」工具權限。
- 查報價收款單據
- 列出、查看報價單、請款單、收據與品項、收款狀態。帳號要有「報價收款」工具權限。
- 建立報價草稿 寫入
- 只建草稿；寄給客戶、轉請款仍由你在「報價收款」確認後操作。帳號要有「報價收款」工具權限。
- 查公司知識庫
- 用關鍵字找公司知識庫的內容（營業時間、服務項目、常見問答…）。
- 看今天要處理
- 首頁「今天要處理」：逾期待收款、待簽合約、待核准請假…
- 看行程
- 排班、請假、合約到期、客戶跟進、收款期限、發薪日。
每日上限：每把金鑰可設每天最多呼叫幾次（預設 1,000 次，台灣時間 00:00 歸零），避免 AI 迴圈打爆。
紀錄：每一次呼叫都記在「設定 › API 與 AI 連線」的呼叫紀錄；AI 新增或修改的資料也會出現在「設定 › 操作紀錄」，操作者顯示 api:金鑰名稱，跟人改的一樣看得到前後差異。
不提供：刪除任何資料、薪資與員工個資。這些請在工具箱畫面操作。
錯誤代碼
| HTTP | code | 意思 |
|---|---|---|
| 400 | invalid | 參數不對，例如統編不是 8 碼、少了客戶名稱。訊息會寫哪一欄。 |
| 401 | missing_key／invalid_key／key_disabled | 沒帶金鑰、金鑰打錯，或金鑰已停用。 |
| 403 | forbidden／account_disabled | 金鑰沒勾這項功能，或代表的帳號沒有該工具的權限、已停用。 |
| 404 | not_found | 找不到這筆客戶或單據。 |
| 409 | duplicate／ambiguous | 統編已經是別的客戶（會附上既有客戶 id），或有同名客戶要改用 id。 |
| 429 | daily_limit | 今天的呼叫次數到上限了，台灣時間 00:00 歸零。 |
| 501 | not_enabled | 這個功能需要的工具還沒啟用（例如公司知識庫）。 |
安全建議
金鑰等於帳號密碼：不要貼到公開的地方、不要傳給別人。金鑰一律放在標頭，不要放進網址。
一個用途一把金鑰：Claude 一把、ChatGPT 一把、自動化流程一把，哪一把出問題就停哪一把，其他不受影響。
只勾需要的功能；給外部或不熟的工具，先開唯讀。
懷疑外洩就到「設定 › API 與 AI 連線」按「停用」，立刻失效，再產生一把新的。