MCP · Streamable HTTP
Timex MCP — เชื่อม AI เข้ากับวันของคุณ
ใช้งานได้ตั้งแต่ Timex 1.3.0
มันคืออะไร
Timex เปิดเซิร์ฟเวอร์ MCP ในเครื่องผ่าน Streamable HTTP ค่าเริ่มต้นคือปิด ผูกกับ 127.0.0.1:41741 เว้นแต่คุณจะเปลี่ยน และป้องกันด้วย bearer token
สำหรับไคลเอนต์ที่เปิดเซิร์ฟเวอร์ stdio ภายใน Timex.app มีบริดจ์ timex-mcp เมื่อเชื่อมต่อแล้ว ไคลเอนต์จะเห็นกิจกรรมที่ Timex บันทึก รวมถึงชื่อหน้าต่างและ URLs
เปิดใช้งาน
- เปิด Settings ▸ Integrations
- เปิด Enable MCP server
- คัดลอก token
ถ้าเปลี่ยน host Timex จะเตือนว่าเซิร์ฟเวอร์อาจเข้าถึงได้จากเครือข่ายของคุณ และยังต้องใช้ bearer token เสมอ
เชื่อมต่อไคลเอนต์
แทน YOUR_TOKEN ด้วย token จาก Timex แล้วเปิดไคลเอนต์ใหม่หลังแก้การตั้งค่า
Claude Code
เพิ่ม Timex เป็นเซิร์ฟเวอร์ Streamable HTTP ระยะไกล
claude mcp add --transport http timex http://127.0.0.1:41741/mcp --header "Authorization: Bearer YOUR_TOKEN"Claude Desktop
ใช้ Add to Claude Desktop ใน Settings ▸ Integrations หรือเพิ่มข้อความนี้ใน ~/Library/Application Support/Claude/claude_desktop_config.json
{"mcpServers":{"timex":{"command":"/Applications/Timex.app/Contents/MacOS/timex-mcp"}}}บริดจ์อ่าน host, port และ token จากค่ากำหนดของ Timex โดย TIMEX_MCP_URL และ TIMEX_MCP_TOKEN ใช้แทนค่าเหล่านี้ได้ หรือใช้ npx -y mcp-remote http://127.0.0.1:41741/mcp --header "Authorization: Bearer YOUR_TOKEN" หากติดตั้ง Node แล้ว
Codex CLI (OpenAI)
Export token แล้วใช้คำสั่ง CLI หรือเพิ่มรายการ TOML ใน ~/.codex/config.toml
export TIMEX_MCP_TOKEN=YOUR_TOKEN
codex mcp add timex --url http://127.0.0.1:41741/mcp --bearer-token-env-var TIMEX_MCP_TOKEN[mcp_servers.timex]
url = "http://127.0.0.1:41741/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }OpenCode
เพิ่มเซิร์ฟเวอร์ระยะไกลนี้ใน opencode.json
{"$schema":"https://opencode.ai/config.json","mcp":{"timex":{"type":"remote","url":"http://127.0.0.1:41741/mcp","enabled":true,"headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}Octomind โดย Muvon GitHub ↗
สำหรับ Octomind ที่รองรับ `headers` (master ปัจจุบัน) ให้เพิ่มเซิร์ฟเวอร์ HTTP นี้และอ้างอิงจาก roles ที่ควรใช้งาน
[[mcp.servers]]
name = "timex"
type = "http"
url = "http://127.0.0.1:41741/mcp"
headers = { Authorization = "Bearer YOUR_TOKEN" }
timeout_seconds = 30
# then add "timex" to server_refs of the roles that should use it:
# [roles.mcp]
# server_refs = ["core", "timex"]url = "http://127.0.0.1:41741/mcp?token=YOUR_TOKEN"สำหรับ Octomind รุ่นเก่าที่ส่ง headers ไม่ได้ ให้ใช้ fallback URL ด้านล่าง Timex ยอมรับ ?token= สำหรับไคลเอนต์ที่ส่ง header ไม่ได้ และควรใช้เฉพาะบน loopback
Cursor
บันทึกไว้ที่ ~/.cursor/mcp.json
{"mcpServers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}Zed
เพิ่มรายการเซิร์ฟเวอร์นี้ในการตั้งค่า MCP ของ Zed
{"mcpServers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}VS Code
บันทึกไว้ที่ .vscode/mcp.json โดย VS Code ใช้คีย์ servers แทน mcpServers
{"servers":{"timex":{"url":"http://127.0.0.1:41741/mcp","headers":{"Authorization":"Bearer YOUR_TOKEN"}}}}เครื่องมือทั้ง 16 รายการ
get_summary สรุปเวลาที่ติดตามในช่วงวันที่
list_activities แสดงบันทึกกิจกรรมในช่วงวันที่
search_activities ค้นหาแอป ชื่อหน้าต่าง และ URLs ที่บันทึกไว้
get_current_activity แสดงสิ่งที่ Timex กำลังติดตามตอนนี้
list_categories แสดงหมวดหมู่และค่าน้ำหนักโฟกัส
list_rules แสดงกฎจัดหมวดหมู่ตามแอป ชื่อ และ URL
add_rule สร้างกฎจัดหมวดหมู่
remove_rule ลบกฎจัดหมวดหมู่
create_category สร้างหมวดหมู่พร้อมค่าน้ำหนักโฟกัส
update_category เปลี่ยนชื่อหมวดหมู่หรือค่าน้ำหนัก
add_manual_entry บันทึกเวลาที่ไม่ได้ติดตามอัตโนมัติ
export_csv ส่งออกช่วงวันที่เป็นไฟล์ CSV
pause_tracking หยุดการติดตามกิจกรรมอัตโนมัติชั่วคราว
resume_tracking ติดตามกิจกรรมอัตโนมัติต่อ
start_break เริ่มช่วงพักใน Timex
list_backups แสดงแบ็กอัปฐานข้อมูล Timex ในเครื่อง
โปรโตคอล: Streamable HTTP; รองรับ protocol revisions 2026-07-28 / 2025-11-25 / 2025-06-18 / 2025-03-26; stateless (ไม่มี sessions); ยอมรับ ?token= สำหรับไคลเอนต์ที่ส่ง header ไม่ได้; จำกัด Origin ไว้ที่ localhost
ตัวอย่างคำถาม
- “สัปดาห์นี้ใช้ Zoom เท่าไรเทียบกับสัปดาห์ก่อน?”
- “วันอังคารช่วงบ่าย 2 ถึง 4 โมงฉันทำอะไรอยู่?”
- “ให้นับ github.com เป็น Development”
- “ลงสายคุยกับลูกค้า 45 นาทีวันนี้ตอนบ่าย 3 ในหมวด Communication”
- “ส่งออกเดือนนี้เป็น CSV ไปที่ ~/Desktop”
แก้ปัญหา
Timex ไม่ได้ทำงานหรือเซิร์ฟเวอร์ MCP ถูกปิด
เปิด Timex แล้วเปิดเซิร์ฟเวอร์ใน Settings ▸ Integrations
401 Unauthorized
สร้างหรือคัดลอก token ใหม่ อัปเดตการตั้งค่า แล้วเปิดไคลเอนต์ใหม่
ผูกกับ host อื่น
ยังต้องใช้ token และยังใช้ ?token= ได้ เมื่อเข้าจากเบราว์เซอร์ การตรวจ Origin อนุญาตเฉพาะ origin ของ localhost