MCP & API銓治 × TaskGo × FRIDAI 11/17 串接會議

銓治工程請 TaskGo 開的兩樣東西:給 Codex+Claude 的 MCP 寫入工具、唯讀 API

2026 年 11 月 17 日(二) 整理:A.Lim(FRIDAI)

①

TaskGo MCP:給 Codex+Claude,能讀也能寫

給銓治的秘書用 Codex 和 Claude 操作 TaskGo,兩個都要能接。第一階段,先做。

金鑰:沿用現在綁「銓治工程」帳號的那一把。

②

唯讀 API:只能讀

給 FRIDAI 的 AI 客服查客人自己的工程進度。第二階段,這次先談做法和時程。

金鑰:新開一把,只能讀。

1

TaskGo MCP 要開的MCP

現在 26 個工具,9 個會寫入,大多只能讀。下面是要加的,優先順序照銓治 11/16 的會議紀錄。

優先:高中也要

功能
優先
要開的
現在
修繕案件
優先高
要開的讀到報修表單全部欄位(客戶來源、LINE ID、案件類型名稱);新增修繕案件;改狀態(含結案);讀得到預計完工日、完工日
現在讀不到客戶來源、LINE ID,類型只回代碼;不能新增、不能改狀態;預計完工日、完工日能寫但讀不回來
照片、影片
優先高
要開的上傳照片、影片、PDF 到案件,標分類(報修、場勘、施工前中後、驗收);說明容量和流量上限
現在只能讀
報價單
優先中
要開的整段估價文案寫進報價單(工法、範圍、天數、注意事項、效期);附照片影片;同一案開第二張;已送出的作廢重開
現在能建草稿(工項、保固)、能送出
派工單
優先中
要開的從報價單產生精簡、沒有金額的派工文字;指派師傅(員工、外包)
現在能組派工文字(要確認有沒有金額)、送出、推 LINE 給已指派的工班
結案報告
優先中
要開的寫入每一段文字;上傳、挑選照片影片
現在只能產生連結,而且要先有客人驗收簽名
任務
優先也要
要開的新增任務(場勘、測漏);指派人員;標完成
現在只能讀
收款
優先也要
要開的新增收款紀錄(期別、金額、日期、匯款或現金);設定分期;讀已收、未收、逾期
現在沒有工具
請款單
優先也要
要開的每一期都能建、能送出;先查之前的金額問題
現在只能建驗收那一期的草稿
發票資料
優先也要
要開的有欄位的話開放寫入:二聯或三聯、抬頭、統編、屋主全名、載具、Email
現在只能填發票日期

所有寫入都要在 TaskGo 留紀錄:誰、什麼時候、改了什麼。

2

唯讀 API 要開的API

客人在 LINE 問「做到哪了」時,FRIDAI 用它查。只查來問的這位客人自己的案子;不能新增、修改、送出、刪除。

要讀的
內容
現在(用 MCP 查的)
找到案子
內容用客人電話查,有沒有「-」都找得到
現在(用 MCP 查的)搜尋只搜案號、地址、聯絡人、內容;用電話查是 0 筆
進度
內容現在在哪一階段、下一步、派工了沒
現在(用 MCP 查的)有
日期
內容預計場勘日、預計施工日、預計完工日、完工日
現在(用 MCP 查的)只回預計場勘日、預計施工日
單據
內容報價單、請款單:寄了沒、簽了沒
現在(用 MCP 查的)看得到報價單,看不到請款單
不能回的
內容廠商派工金額、客人看不到的內部留言、師傅電話
現在(用 MCP 查的)會一起回

3

MCP 怎麼開Setup

新工具加在現在這個 MCP 裡,不用另開網址、不用換金鑰。工具名稱是建議,TaskGo 可以自己定。

連線:沿用現在的網址和金鑰,Codex、Claude 都接得上

網址 https://api.dev.taskgo.com.tw/mcp(Streamable HTTP),標頭 x-api-key,金鑰綁「銓治工程」帳號。

Codex

# ~/.codex/config.toml
[mcp_servers.taskgo]
url = "https://api.dev.taskgo.com.tw/mcp"
http_headers = { "x-api-key" = "tg_…" }

Claude Code

claude mcp add --transport http taskgo \
  https://api.dev.taskgo.com.tw/mcp \
  --header "x-api-key: tg_…"

Claude 桌面版、網頁版的「自訂連接器」:用 API key(Request headers)目前還是測試功能,不是每個帳號都有。要在那裡穩定能用,請 TaskGo 加 OAuth 登入(支援 Dynamic Client Registration 最省事)。只用 Codex、Claude Code 的話,現在的 x-api-key 就夠。

要加的工具:參數和規則

加功能現有工具多收或多回欄位 新工具名稱是建議

工具
要收的參數
回傳、規則
get_repair_case
加功能
要收的參數—
回傳、規則多回:客戶來源 source、LINE ID line_id、案件類型名稱 category_name、預計完工日 planned_complete_at、完工日 completed_at
create_repair_case
新工具
要收的參數聯絡人 contact_name、電話 contact_phone、地址 address、修繕內容 description、案件類型 category、客戶來源 source、LINE ID line_id(選填)
回傳、規則回案號 case_no;跟報修表單送出一樣,自動建場勘、報價、施工、驗收、請款 5 個任務
update_repair_case
加功能
要收的參數狀態 status(含結案)
回傳、規則能改狀態、結案;已簽名的金額照舊不能改
upload_repair_media
新工具
要收的參數case_no、檔案網址 file_url、分類 phase(報修、場勘、施工前、施工中、施工後、驗收)、說明 caption
回傳、規則照片、影片、PDF 都收;收網址由 TaskGo 下載(Codex、Claude 手上的是 FRIDAI 存的 LINE 照片網址);回 media_id;寫明單檔和總容量上限
create_repair_quotation_draft
加功能
要收的參數整段估價文案 description、工法 method、範圍 scope、天數 days、注意事項 notes、效期 valid_until、附件 media_ids
回傳、規則同一案可以開第二張
void_repair_quotation
新工具
要收的參數quotation_id、原因 reason
回傳、規則作廢已送出的報價單,再用上一個工具重開
get_repair_dispatch_text
加功能
要收的參數不顯示金額 hide_amounts、精簡版 format
回傳、規則回地址、施工項目、工法、材料、日期,能直接貼到 LINE
assign_repair_worker
新工具
要收的參數case_no、師傅 staff_id 或外包 vendor_id、日期 date
回傳、規則指派後就能用現有的 send_repair_line 推 LINE
create_repair_task
complete_repair_task
新工具
要收的參數case_no、類型 type(場勘、測漏)、負責人 assignee、日期 due_at;標完成收 task_id
回傳、規則任務標完成,案件階段要跟著往前
add_repair_payment
list_repair_payments
新工具
要收的參數case_no、期別 installment、金額 amount、日期 paid_at、方式 method(匯款、現金);查詢收 status(已收、未收、逾期)
回傳、規則支援分期(30%、30%、40%)
create_repair_billing
send_repair_billing
新工具
要收的參數case_no、期別 installment
回傳、規則每一期都能建、能送出
update_repair_closeout_report
新工具
要收的參數case_no、範本 template_id、段落 sections(標題+內文)、照片影片 media_ids
回傳、規則寫完再用現有的 prepare_repair_closeout 產生連結
update_repair_invoice_info
新工具
要收的參數case_no、二聯或三聯 invoice_type、抬頭 title、統編 tax_id、屋主全名 owner_name、載具 carrier、email
回傳、規則TaskGo 有這些欄位才需要

每個寫入工具都要做到

4

唯讀 API 怎麼開Setup

給 FRIDAI 系統接,不是給人用。格式 TaskGo 定,下面是建議。

項目
建議
形式
HTTPS,只有 GET,回 JSON
認證
標頭 x-api-key,新開一把,只能讀修繕案件;只回銓治工程的案子
找案子
GET /repair-cases?phone=0939135271
電話先拿掉「-」和空白再比對;聯絡人、屋主、房客的電話都比。回案號、地址、建立日、狀態;一支電話可能有好幾案
案子內容
GET /repair-cases/{case_no}
只回客人能看的,見下面範例
不能回
廠商派工單和金額、客人看不到的內部留言(visible_to_client 是 false 的)、師傅電話
查不到
回空陣列,不要回錯誤
給我們
API 文件、網址、一把測試金鑰;FRIDAI 這邊來接

案子內容的回傳範例(欄位名 TaskGo 自己定)

{
  "case_no": "T202611001",
  "stage": "正式派工驗收",
  "next_action": "驗收",
  "planned_survey_at": "2026-11-05",
  "planned_work_at": "2026-11-20",
  "planned_complete_at": "2026-12-01",
  "completed_at": null,
  "dispatched_at": "2026-11-18",
  "documents": [
    { "type": "quotation", "sent_at": "2026-11-08", "signed_at": "2026-11-09" },
    { "type": "billing", "installment": 2, "sent_at": null, "signed_at": null }
  ],
  "photos": [ { "phase": "during", "url": "https://…" } ]
}

5

金鑰、權限、請 TaskGo 回覆的Keys

兩把金鑰分開,權限只開需要的。

① MCP
② 唯讀 API
給誰用
① MCP銓治的秘書(用 Codex 和 Claude)
② 唯讀 APIFRIDAI 系統
金鑰
① MCP沿用綁「銓治工程」帳號的那一把(看得到全部案子)
② 唯讀 API新開一把,只能讀,只存在 FRIDAI 系統
權限
① MCP能讀也能寫
② 唯讀 API只能讀
什麼時候
① MCP第一階段,先做
② 唯讀 API第二階段

兩把都不需要:刪除資料、改已簽名的金額、人員和薪資、組織設定和付款、倉庫和庫存。

請 TaskGo 回覆

  1. 1客人的驗收簽名怎麼產生?結案報告、驗收標完成,都要先有這個簽名
  2. 2照片、影片的容量和流量上限是多少?施工照片以後都要進 TaskGo
  3. 3請款單之前的金額問題,修好了嗎?銓治說之前金額不對,所以現在沒在用
  4. 4時程① 什麼時候可以先在範例案測寫入;② 唯讀 API 什麼時候能做