ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว เข้าสู่ระบบ

Sanka

โดย sankaHQรุ่น 1.0.0i★ 0iรันบนคลาวด์เว็บทางการ ↗
ชื่อใน registryio.github.sankaHQ/sanka-mcp

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ คลาวด์ (ต่อผ่านอินเทอร์เน็ต)
  • บัญชีหรือคีย์ ล็อกอินกับบริการตอนต่อ (OAuth)
  • หมวด อื่น ๆ
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Sanka Desk IT requests, Sanka Flow records, approvals, workflows and app migrations, with OAuth.

ทำไมอยู่อันดับนี้

หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้

ความนิยม0/80ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20
ความสด12/12ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม
ระบบยังตอบ8/8endpoint บนคลาวด์ตอบตอนตรวจล่าสุด
คะแนนการใช้งาน20/100

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 5/5 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ให้ AI ติดตั้งให้ด้วยประโยคเดียว

ติดตั้ง Sanka ให้หน่อย ทำตาม https://mcp.popnx.com/i/sankahq-sanka-mcp.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรัน

คัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน

ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (mcp.sanka.com) · ✓ ตรวจคำสั่งแล้ว 20 พ.ย. 2569

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม

  1. เปิดหน้า Connectors ของ Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้

    คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue

    Name · ชื่อSanka
    Remote MCP server URL · ที่อยู่https://mcp.sanka.com/mcp

    กด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add

  3. เปิดใช้ในแชต

    +ConnectorsSanka

  4. ลองเลย

    ใช้ Sanka บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ Sanka หรือมีชื่อเครื่องมือของ Sanka ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ ChatGPT ได้ ขึ้นกับแผน

MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น

  1. เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. กรอกชื่อและที่อยู่

    ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin

    Name · ชื่อSanka
    Connection · ที่อยู่https://mcp.sanka.com/mcp
  3. เลือก Sanka ในแชต

    เปิดแชตใหม่แล้วเลือก Sanka จากรายการปลั๊กอินก่อนพิมพ์

  4. ลองเลย

    ใช้ Sanka บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า ChatGPT บอกว่ากำลังใช้ Sanka หรือมีชื่อเครื่องมือของ Sanka ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Claude Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell

  2. วางคำสั่งนี้แล้วกด Enter

    claude mcp add --transport http --scope user sanka https://mcp.sanka.com/mcp
  3. พิมพ์ /mcp ใน Claude Code

    ต้องเห็น Sanka ในรายการและขึ้นว่าเชื่อมต่อแล้ว

  4. ลองเลย

    ใช้ Sanka บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude Code บอกว่ากำลังใช้ Sanka หรือมีชื่อเครื่องมือของ Sanka ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Cursor ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด Cursor

    เปิดใน Cursor

    Cursor จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน Cursor โหมด Agent

  3. ลองเลย

    ใช้ Sanka บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Cursor บอกว่ากำลังใช้ Sanka หรือมีชื่อเครื่องมือของ Sanka ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด VS Code

    เปิดใน VS Code

    VS Code จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน VS Code โหมด Agent

  3. ลองเลย

    ใช้ Sanka บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า VS Code บอกว่ากำลังใช้ Sanka หรือมีชื่อเครื่องมือของ Sanka ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ

ที่อยู่https://mcp.sanka.com/mcp

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Sanka อยู่💬 พูดคุย →
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ต่อผ่านเว็บ

Claude Code

claude mcp add --transport http --scope user sanka https://mcp.sanka.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "sanka": {
      "url": "https://mcp.sanka.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "sanka": {
      "type": "http",
      "url": "https://mcp.sanka.com/mcp"
    }
  }
}

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาวน์โหลดต่อสัปดาห์i
ไม่มียอดใน npm/PyPI
licensei
Apache-2.0
การเชื่อมต่อ
รันบนคลาวด์
รุ่นล่าสุดi
1.0.0
หมวดi
อื่น ๆ
ส่งเข้า registryi
20 พ.ย. 2569
แก้โค้ดล่าสุดi
20 พ.ย. 2569
ตรวจล่าสุดเมื่อ
20 พ.ย. 2569
ผู้ทำ
sankaHQ
เว็บผู้ทำ
sanka.com
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ต่อผ่านคลาวด์ได้ใน

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

server ให้ล็อกอินก่อนจึงจะแสดงรายการเครื่องมือ

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 20 พ.ย. 2569

  • ✓ ผ่าน

    ตัวตนผู้ทำตรงกับ repo

    ชื่อใน registry ยืนยันด้วยบัญชี GitHub sankaHQ ซึ่งเป็นเจ้าของ repo

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด วันนี้

  • ✓ ผ่าน

    มีสัญญาอนุญาต (license)

    ใช้ Apache-2.0

  • ✓ ผ่าน

    endpoint ตอบ

    ตอบกลับใน 353 ms (HTTP 401)

  • ✓ ผ่าน

    ล็อกอินแบบ OAuth

    ประกาศวิธีล็อกอินแบบ OAuth ให้โปรแกรม AI พาไปล็อกอินเอง

  • … ยังไม่ตรวจ

    คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

    ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/sankahq-sanka-mcp.svg?lang=th)](https://mcp.popnx.com/th/servers/sankahq-sanka-mcp)

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบเพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด อื่น ๆi

  • ดาวมากกว่า 0% ของอีก 20958 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 99% ของอีก 20958 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 20958 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Sanka ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนคลาวด์ของผู้ทำ ต่อผ่านอินเทอร์เน็ตได้เลย ไม่ต้องลงโปรแกรม แต่ข้อมูลที่ส่งให้จะผ่านเซิร์ฟเวอร์ของผู้ทำ

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด วันนี้ และส่งรุ่นล่าสุด (1.0.0) เข้า registry วันนี้

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

ตัวอื่นที่ทำงานคล้ายกัน

หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

World Monitor

ข่าวกรองโลกแบบเรียลไทม์: ความขัดแย้ง ตลาด พลังงาน การค้า การขนส่ง และไซเบอร์

โดย koala73ใช้กันมาก★ 90.9Kอัปเดต 4 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

โดย openstatusHQใช้กันมาก★ 9.3Kอัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

โดย JanDeDobbeleerใช้กันมาก★ 23.8K ดาวรวมทั้งรีโปอัปเดต 31 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

โดย Klavis-AIกำลังโต★ 5.8Kอัปเดต 14 เดือนที่ผ่านมา

รันบนคลาวด์repo ถูกเก็บถาวร✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

โดย jitsucomใช้กันมาก★ 5.1Kอัปเดต 4 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · jitsu.com
เทียบกับตัวที่คล้ายกัน
ตัวนี้
Sanka
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
ทำงานที่ไหนใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่อง
ต้องใส่คีย์ไม่ไม่ไม่ไม่ไม่ไม่
กด + ใน Claude ได้ไม่ไม่ไม่ไม่ไม่ไม่
ผลตรวจเบื้องต้น5/54/44/44/41/44/4
สัญญาอนุญาตApache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
ราคาไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียน

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Sanka MCP Server

This repository contains the hosted Sanka MCP service and the TypeScript client it uses to call Sanka's externally callable API surface. It is now maintained as a normal TypeScript workspace, not as a Stainless-managed repository.

The production service is a remote Streamable HTTP MCP endpoint:

  • POST /mcp as the primary endpoint
  • POST /sse as a compatibility alias for clients that still expect an SSE-style path
  • POST / as a compatibility alias
  • GET /health for health checks

The /mcp endpoint exposes both the general SDK tools and the read-only CRM tools from a single MCP surface.

Live endpoints:

  • https://mcp.sanka.com/mcp
  • https://mcp.sanka.com/sse

Staging endpoint:

  • https://sanka-mcp-staging.fly.dev/mcp

Repository layout

  • src/: TypeScript client for Sanka's externally callable API surface, used by the MCP service
  • src/internal/: package-private SDK runtime helpers, not Sanka private backend code
  • packages/mcp-server/: the MCP server application and Docker entrypoint
  • .github/workflows/: CI plus staging and production Fly deployment workflows
  • fly.toml: production Fly app configuration
  • fly.staging.toml: staging Fly app configuration
  • docs/openapi-maintenance.md: guidance for keeping API coverage current without Stainless

Auth

The hosted server is a standard MCP OAuth 2.1 protected resource (MCP authorization spec 2026-07-28). Sanka (sanka-api) is the authorization server, issuer https://api-v2.sanka.com/oauth/mcp; the consent page is https://app.sanka.com/oauth/mcp/authorize.

  • Every MCP request needs Authorization: Bearer . Without one the server answers 401 with WWW-Authenticate: Bearer scope="mcp:access", resource_metadata="…"; an invalid or expired token adds error="invalid_token".
  • Each endpoint is its own resource, named by the URL clients connect to: https://mcp.sanka.com/mcp, https://mcp.sanka.com/sse and https://mcp.sanka.com. Its RFC 9728 metadata is at /.well-known/oauth-protected-resource/mcp, …/sse and /.well-known/oauth-protected-resource. A token is bound to one resource.
  • /.well-known/oauth-authorization-server mirrors Sanka's metadata for clients built for the 2025-03-26 protocol.
  • Clients register with a Client ID Metadata Document (preferred) or dynamic client registration, and always use PKCE (S256); Sanka issues no client secrets.
  • The server never passes the client's token to the business API. It exchanges it through POST /oauth/internal/mcp-oauth-token (authenticated with MCP_SERVER_OAUTH_RESOURCE_SERVER_SECRET, shared with sanka-api only) for its own short-lived API token bound to the same connection. Sanka checks the connection on every API call, so disconnecting a client takes effect at once.
  • switch_workspace moves the whole connection to the chosen workspace, so later token exchanges and record URLs follow it.
  • The server keeps no MCP session: a client-sent mcp-session-id is ignored and never forwarded. Developer API keys (X-Sanka-API-Key) are refused.

The ChatGPT connector keeps its own resource at /chatgpt with its own issuer (https://api-v2.sanka.com/oauth/chatgpt).

Local development

pnpm install

pnpm build export MCP_SERVER_OAUTH_ISSUER="http://localhost:8000/oauth/mcp" export MCP_SERVER_INTERNAL_AUTHORIZATION_SERVER_URL="http://localhost:8000" export MCP_SERVER_OAUTH_RESOURCE_SERVER_SECRET=" " export MCP_SERVER_RESOURCE_URL="http://localhost:8080/mcp" export SANKA_BASE_URL="http://localhost:8000" node packages/mcp-server/dist/index.js --transport=http --port=8080

The local API needs the matching settings: MCP_OAUTH_ISSUER, MCP_OAUTH_AUTHORIZE_URL (the local React app's /oauth/mcp/authorize), MCP_OAUTH_RESOURCES (a JSON list with http://localhost:8080/mcp and the other local endpoints) and the same MCP_OAUTH_RESOURCE_SERVER_SECRET.

Stdio remains a local-development transport. SANKA_API_KEY there is process configuration, not a client-supplied bearer mode.

Then verify:

curl http://127.0.0.1:8080/health

curl -sS -D - http://127.0.0.1:8080/mcp \ -H 'content-type: application/json' \ -H 'accept: application/json, text/event-stream' \ --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0.1"}}}'

The initialize request answers 401 with the WWW-Authenticate challenge. Point an HTTP MCP client (for example the MCP Inspector) at http://127.0.0.1:8080/mcp without static auth headers; it discovers the authorization server, opens the Sanka consent page, and retries with its token. curl http://127.0.0.1:8080/.well-known/oauth-protected-resource/mcp shows the resource metadata.

Browser Use worker

The browser_use MCP tool dispatches allowlisted browser workflows to a separate worker. The MCP server keeps session authentication, audit metadata, workflow routing, and confirmation gates; the worker owns browser state and third-party UI interaction. The first registered workflow is:

  • demo.hubspot.company_avatar: update HubSpot demo company avatars through the HubSpot UI when CRM APIs cannot set the visible avatar.

Run a local worker with agent-browser:

npm install -g agent-browser

agent-browser install

export SANKA_BROWSER_USE_WORKER_TOKEN="local-worker-token" export SANKA_BROWSER_USE_PROFILE_ROOT=".browser-use-profiles" export SANKA_BROWSER_USE_ARTIFACT_DIR=".browser-use-artifacts" pnpm --dir packages/mcp-server browser-use-worker

Point the MCP server at it:

export SANKA_BROWSER_USE_WORKER_URL="http://127.0.0.1:8787/run"

export SANKA_BROWSER_USE_WORKER_TOKEN="local-worker-token"

For production, deploy the worker as a separate service, for example on Fly, with a persistent volume mounted at SANKA_BROWSER_USE_PROFILE_ROOT so HubSpot login cookies survive restarts. Keep the worker private or token-protected and only expose /run to the MCP service.

See docs/browser-use-worker-fly.md for the Fly worker app, persistent volume, secret wiring, and profile seeding runbook.

Deployment

This repo deploys to Fly from packages/mcp-server/Dockerfile.

  • Manual production deploy: fly deploy -c fly.toml
  • Manual staging deploy: fly deploy -c fly.staging.toml
  • Automatic staging deploy: push to staging
  • Automatic production deploy: publish a GitHub release that targets main

Release Flow

Use the same promotion shape as the main Sanka app:

  1. Open feature PRs into staging.
  2. Merge staging after CI passes to deploy sanka-mcp-staging.
  3. Validate the staging MCP endpoint.
  4. Open staging -> main.
  5. After main is ready, run Create new Sanka MCP Tag and Release.
  6. The published release deploys production.

Required Fly apps and secrets:

  • Production app: sanka-mcp
  • Staging app: sanka-mcp-staging
  • Set the same MCP_SERVER_* secrets on both apps unless staging intentionally uses a different auth stack.

Retry policy

The TypeScript client retries 408, 409, 429, 5xx and connection errors twice by default. Only tools with metadata.operation: 'read' keep those automatic retries. Every write tool calls the API once and returns any error to the agent: a write can fail after its side effect happened, such as an email Gmail accepted before Sanka recorded it, and a retry would repeat it. The API also marks errors from delivery routes with x-should-retry: false. Reply tools report DELIVERY_UNKNOWN as a do-not-resend error.

Maintenance direction

This repository no longer depends on Stainless project access at runtime or for ongoing development. API coverage should be maintained directly in this repo.

The recommended next step is to adopt open-source OpenAPI tooling for updates to the TypeScript client, rather than reintroducing a hosted generator dependency. See openapi-maintenance.md.

The repo now includes a starter typegen command:

pnpm generate:openapi-types

By default it reads the sibling Sanka spec at ../sanka-sdks/openapi.json.

Developer Cloud (release candidate)

The hosted tools expose the same V2 source, run, receipt, certificate and Fleet contracts as the CLI and SDKs. This source change does not enable production execution. Read get_developer_cloud_availability first and obey each capability's availability flag. Free local migration and client-evidence registration are unchanged.

Every call takes a pinned workspace_id. Paid creates and selective retries require an explicit request, approved cap, confirm: true, and stable idempotency_key. Existing user authorization is sufficient. A lost response must not create a new intent: read back or replay the identical key and request. No tool purchases credits, creates repository PRs, merges, or deploys.

  • Source/run: upload_developer_cloud_source, create_developer_cloud_run, list_developer_cloud_runs, get_developer_cloud_run, cancel_developer_cloud_run.
  • Evidence: list_developer_cloud_events, get_developer_cloud_receipt, list_developer_cloud_artifacts, download_developer_cloud_artifact.
  • Certificates: list_developer_cloud_certificate_keys, get_developer_cloud_certificate, revoke_developer_cloud_certificate.
  • Fleet: create_developer_cloud_fleet, list_developer_cloud_fleets, get_developer_cloud_fleet, cancel_developer_cloud_fleet, retry_developer_cloud_fleet.

Repair and certificate issuance use create_developer_cloud_run.request.repair and .certification, respectively. Compute is 25 credits per worker-minute, rounded once per run. Successful Repair adds 250 credits; independent certificate issuance adds 500 (1 credit = ¥1 or 1 cent since 2026-11-20). All compute and premiums remain within the approved cap. Failed gates have no premium. Fleet adds no surcharge: its cap is the sum of explicit child caps, reserved atomically, with at most five active workers per workspace. Retry selects only failed children after the original Fleet settles; it creates a new Fleet and preserves completed children's receipts.

Upload the exact ZIP digest and declared full revision; the service pins uploaded bytes but does not independently prove their Git provenance. Inspect certificate scope, scenarios, limitations and revocation. Downloading a certificate does not verify its signature: use the CLI's offline verification with the published key. Artifact downloads verify bytes against recorded SHA-256 metadata. MCP supports up to 64 MiB; larger artifacts use the CLI/API. Large downloads use the existing session-bound URL or read_binary_download_chunk flow.

Request-schema regeneration uses the shared V2 SDK input:

python3 scripts/sync-developer-cloud-contract.py ../sanka-sdks/openapi.json

pnpm exec prettier --write packages/mcp-server/src/generated/developer-cloud-schemas.ts

Embedded workspace

The Sanka app opens the connected full Flow workspace: its sidebar, dashboards, record tables, workflows and reports. Full workspace access requires explicit Sanka authorization. Connections with narrower access show the authorization controls; the earlier Invoice assistant pilot screen is no longer offered.

The hosted invoice MCP tools remain available under their existing scopes and confirmation requirements. Removing the pilot screen does not change invoice records or the API contract.