เชื่อมต่อ MCP

เชื่อมไคลเอนต์ AI กับพื้นที่ทำงานจริงใน MANA แล้วตรวจสอบรายการเครื่องมือก่อนอนุญาตให้อ่านหรือเปลี่ยนแปลงข้อมูล

คุณทำอะไรได้บ้าง

Model Context Protocol (MCP) ทำให้ไคลเอนต์ AI ขอให้ MANA ทำงานบางอย่างในพื้นที่ทำงานของคุณได้ เมื่อเชื่อมแล้ว AI สามารถสร้างโปรเจกต์ แยกบรีฟเป็นงาน จัดการป้ายกำกับงาน ร่างหรือเผยแพร่เอกสาร บันทึกรายจ่าย ดูปฏิทิน หรือสรุปประวัติลูกค้าได้

นี่คือชุดการทำงานของ MANA ที่คัดให้ปลอดภัย ไม่ใช่การเปิดทุกหน้าจอหรือทุกบริการภายใน ไคลเอนต์จะค้นหารายการเครื่องมือที่ใช้ได้ให้อัตโนมัติหลังเชื่อมต่อ

AIไคลเอนต์

MANA MCP

เครื่องมือเครื่องมือในเวิร์กสเปซ

ยืนยันตัวตนใช้ Bearer token จากการตั้งค่า MANA

ค้นหาเครื่องมือไคลเอนต์โหลดเครื่องมือที่พร้อมใช้

เริ่มทำงานทุกคำสั่งจำกัดอยู่ในบัญชีของคุณ

ไคลเอนต์ส่งคำสั่งเครื่องมือที่ยืนยันตัวตนแล้วมายัง MANA และ MANA จะดำเนินการเฉพาะกับบัญชีที่เป็นเจ้าของโทเค็น

ขั้นตอนโดยย่อ

1
คัดลอกการตั้งค่าส่วนตัว
เปิด ตั้งค่า → AI → การเชื่อมต่อ MCP แล้วกด คัดลอกการตั้งค่า ข้อมูลจะมีโทเค็นส่วนตัวและที่อยู่ของ MANA แยกกัน
2
เพิ่ม MANA ในไคลเอนต์
เลือกไคลเอนต์ด้านล่าง แล้ววางคำสั่งหรือการตั้งค่าที่กำหนด หากเปิดไคลเอนต์อยู่แล้ว ให้ปิดแล้วเปิดใหม่
3
ตรวจสอบก่อนเริ่มใช้งาน
ดูรายการเซิร์ฟเวอร์ MCP หรือเรียกตรวจสอบเซิร์ฟเวอร์โดยตรง หากพบรายการเครื่องมือ แสดงว่าการเชื่อมต่อสำเร็จ

รับโทเค็น

ใน MANA เปิด ตั้งค่า → AI → การเชื่อมต่อ MCP แล้วกด คัดลอกการตั้งค่า เก็บโทเค็นส่วนตัวไว้ในชื่อ MANA_MCP_TOKEN โดยที่อยู่ของ MANA จะไม่มีโทเค็นอยู่ในนั้น

เก็บโทเค็นไว้ในตัวแปรสภาพแวดล้อม แทนการวางลงในไฟล์ตั้งค่าที่แชร์ร่วมกัน:

export MANA_MCP_TOKEN=your-token-here

รายละเอียดการเชื่อมต่อ

ปลายทาง	`https://mana-api.fly.dev/mcp`
รูปแบบรับส่งข้อมูล	Streamable HTTP แบบไม่เก็บสถานะเซสชัน
การยืนยันตัวตน	`Authorization: Bearer YOUR_TOKEN`

ใช้รูปแบบ bearer token เท่านั้น MANA ไม่รับโทเค็นใน URL เพราะ URL อาจอยู่ในประวัติเบราว์เซอร์หรือบันทึกการเข้าถึงได้

สิ่งที่ยังเป็นส่วนตัว

การเชื่อมต่อนี้เข้าถึงได้เฉพาะบัญชี MANA ที่เป็นเจ้าของโทเค็นเท่านั้น
รายการเครื่องมือและผลการอ่านถูกจำกัดไว้ เพื่อให้ไคลเอนต์เริ่มจากข้อมูลเท่าที่จำเป็น
MANA HQ สามารถปิดเครื่องมือภายนอกรายตัวสำหรับการเชื่อมต่อของคุณได้ทุกเมื่อ
การทำงานกับ Google Calendar ต้องผ่านการเชื่อมต่อและข้อกำหนดแผนของ MANA โดย MANA จะไม่ส่ง Google OAuth token ให้ไคลเอนต์ AI
ก่อนที่ไคลเอนต์ AI จะเผยแพร่เอกสารหรือส่งการเปลี่ยนแปลงไปยัง Google Calendar ที่เชื่อมไว้ ไคลเอนต์ต้องขอการยืนยันจากคุณก่อน
การดูแลโครงสร้างพื้นฐานและผู้ให้บริการ เช่น Neon, Sentry, Cloudflare และ Stripe ไม่ใช่ MCP tools

เลือกไคลเอนต์

เปิดดูวิธีตั้งค่าทีละรายการ บล็อกโค้ดทุกชุดมีปุ่ม คัดลอก

Claude Code

claude mcp add --transport http mana https://mana-api.fly.dev/mcp \
  --header "Authorization: Bearer $MANA_MCP_TOKEN"

เพิ่ม --scope user เพื่อให้ MANA ใช้ได้ในทุกโปรเจกต์ แทนเฉพาะโปรเจกต์ปัจจุบัน ตรวจสอบด้วย claude mcp list

Codex

เพิ่ม MANA ใน ~/.codex/config.toml:

[mcp_servers.mana]
url = "https://mana-api.fly.dev/mcp"
bearer_token_env_var = "MANA_MCP_TOKEN"

กำหนด MANA_MCP_TOKEN ในสภาพแวดล้อมที่ใช้เปิดแอป Codex, CLI หรือส่วนขยาย IDE แล้วปิดและเปิดไคลเอนต์ใหม่

Gemini CLI

gemini mcp add --transport http mana https://mana-api.fly.dev/mcp \
  --header "Authorization: Bearer $MANA_MCP_TOKEN"

หรือเพิ่มการตั้งค่านี้ใน ~/.gemini/settings.json:

{
  "mcpServers": {
    "mana": {
      "httpUrl": "https://mana-api.fly.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Cursor

ใช้ ~/.cursor/mcp.json สำหรับทุกโปรเจกต์ หรือ .cursor/mcp.json สำหรับโปรเจกต์เดียว:

{
  "mcpServers": {
    "mana": {
      "url": "https://mana-api.fly.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code

เพิ่ม .vscode/mcp.json ในพื้นที่ทำงาน:

{
  "servers": {
    "mana": {
      "type": "http",
      "url": "https://mana-api.fly.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Claude Desktop

เมื่อติดตั้ง Bun แล้ว ให้เชื่อมปลายทางผ่าน mcp-remote ใน claude_desktop_config.json:

{
  "mcpServers": {
    "mana": {
      "command": "bunx",
      "args": ["mcp-remote", "https://mana-api.fly.dev/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_TOKEN" }
    }
  }
}

โทเค็นอยู่ใน env และอาร์กิวเมนต์ header ไม่มีช่องว่างหลังเครื่องหมายโคลอน เพื่อป้องกันไม่ให้ไคลเอนต์บน Windows แยกค่าไม่ถูกต้อง

ไคลเอนต์ MCP อื่น

ไคลเอนต์ใดก็ตามที่รองรับ Streamable HTTP สามารถใช้งานได้ กำหนดปลายทาง ส่ง Authorization header แล้วให้ไคลเอนต์ค้นหารายการเครื่องมือเมื่อเชื่อมต่อ

ตรวจสอบการเชื่อมต่อ

ก่อนสรุปว่าไคลเอนต์มีปัญหา ให้ตรวจสอบเซิร์ฟเวอร์โดยตรง:

curl -s https://mana-api.fly.dev/mcp \
  -H "Authorization: Bearer $MANA_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

หากได้รับ JSON ที่มีรายการเครื่องมือ แสดงว่าการเชื่อมต่อสำเร็จ Unauthorized หมายถึงไคลเอนต์ไม่ได้ส่ง bearer token ที่ยังใช้งานได้ ให้คัดลอกการตั้งค่าอีกครั้ง หรือสร้างโทเค็นใหม่ใน MANA หากคิดว่าโทเค็นรั่ว

หากการตรวจสอบโดยตรงสำเร็จแต่ไคลเอนต์ยังใช้ไม่ได้ ให้ปิดแล้วเปิดไคลเอนต์ใหม่ และตรวจสอบว่า MANA_MCP_TOKEN มองเห็นได้ในสภาพแวดล้อมที่ใช้เปิดไคลเอนต์