วิธีเชื่อมต่อผู้ช่วย IA กับ MCP ROOTE?

เพื่อเชื่อมต่อผู้ช่วย IA กับ MCP ROOTE ให้เพิ่มเซิร์ฟเวอร์ระยะไกล https://mcp.roote.ai/mcp ในแอปที่รองรับ MCP Streamable HTTP เซิร์ฟเวอร์ให้บริการเครื่องมืออ่านข้อมูลสำหรับที่อยู่ การเดินทาง และบริการใกล้เคียง

บทแนะนำนี้ติดตามการตั้งค่าที่เผยแพร่โดย ROOTE และการตรวจสอบการเชื่อมต่อกับเซิร์ฟเวอร์ ชื่อเมนูอาจเปลี่ยนตามไคลเอนต์ URL การขนส่ง และสกีมาเครื่องมือเป็นส่วนที่ต้องตรวจสอบ รายการ tools/list ของเซิร์ฟเวอร์อาจเปลี่ยนแปลงก่อนเอกสารอย่างเป็นทางการ: ใช้ความสามารถที่ประกาศจริงเท่านั้น

ตรวจสอบความเข้ากันได้ของไคลเอนต์

แอปของคุณต้องรองรับเซิร์ฟเวอร์ MCP ระยะไกลในรูปแบบ Streamable HTTP ไคลเอนต์ที่จำกัดเฉพาะเซิร์ฟเวอร์ท้องถิ่น stdio ไม่สามารถใช้ URL นี้เป็นคำสั่งที่รันได้ ตรวจสอบอีกครั้งด้วยว่าบัญชีของคุณอนุญาตเพิ่มเซิร์ฟเวอร์แบบกำหนดเองได้หรือไม่

หากแอปมีแบบฟอร์ม ให้กรอกชื่อเป็น ROOTE และ URL เซิร์ฟเวอร์เป็นที่อยู่ หากรับไฟล์ในรูปแบบ mcpServers เอกสาร ROOTE มีการตั้งค่าขั้นต่ำนี้:

{
  "mcpServers": {
    "roote": { "url": "https://mcp.roote.ai/mcp" }
  }
}

การตั้งค่าการเชื่อมต่ออย่างเป็นทางการของ ROOTE

เลือกการเข้าถึงแบบไม่ระบุตัวตนหรือการยืนยันตัวตน

เอกสารมีการเข้าถึงแบบไม่ระบุตัวตนโดยไม่มีหัวข้อ Authorization โดยอยู่ภายใต้การใช้งาน Free และข้อจำกัด API ปัจจุบัน สำหรับการเข้าถึงที่ยืนยันตัวตน ให้ใช้ระบบรักษาความปลอดภัยของไคลเอนต์ส่งโทเค็นของคุณในหัวข้อ Bearer

Authorization: Bearer YOUR_API_TOKEN

YOUR_API_TOKEN เป็นตำแหน่งที่ต้องเปลี่ยนในการตั้งค่าความปลอดภัยของไคลเอนต์ อย่าแปะโทเค็นในบทสนทนา URL สาธารณะ หรือบทความ โทเค็นที่ไม่ถูกต้องหรือถูกเพิกถอนจะไม่ถูกแทนที่โดยอัตโนมัติด้วยการเข้าถึงแบบไม่ระบุตัวตน

ยืนยันว่าเครื่องมือพร้อมใช้งาน

หลังเชื่อมต่อ เปิดรายการเครื่องมือของเซิร์ฟเวอร์ในไคลเอนต์ เอกสาร ROOTE อธิบายลำดับ initialize, tools/list และ tools/call; ไคลเอนต์ที่รองรับจะทำขั้นตอนเหล่านี้ให้โดยปกติ ใช้งานเวอร์ชันและความสามารถที่เซิร์ฟเวอร์ประกาศ

เซิร์ฟเวอร์ให้บริการ geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions และ services_nearby หากเครื่องมือเหล่านี้ไม่มี หมายถึงมีปัญหาเรื่องการเชื่อมต่อ การค้นพบ หรือการเปลี่ยนแปลงของบริการ โปรดตรวจสอบรายการที่เซิร์ฟเวอร์ประกาศอย่างสม่ำเสมอ Journey และ Departures ยังไม่ถูกเปิดให้บริการในตอนนี้

ทำการค้นหาแรกที่ทำซ้ำได้

เริ่มด้วยที่อยู่ชัดเจน: “ใช้ ROOTE ค้นหา 10 rue de Rivoli, Paris, France แจ้งผู้สมัครที่พบและพิกัดของพวกเขา” ตรวจสอบผลลัพธ์ของเครื่องมือไม่ใช่แค่ข้อความตอบของโมเดล

{
  "name": "geocode",
  "arguments": {
    "q": "10 rue de Rivoli, Paris",
    "language": "fr",
    "country": "FR"
  }
}

บล็อกนี้แสดงชื่อและอาร์กิวเมนต์ของการเรียก ไม่ใช่คำขอ HTTP ทั้งหมด ไคลเอนต์ของคุณจะครอบคำเรียก MCP หากมีตัวเลือกหลายตัวเลือกให้เลือกถูกต้องก่อนค้นหาบริเวณนั้น

คุณสามารถทดสอบการขนส่งโดยรอบจุดอ้างอิงที่บอร์โดซ์ พิกัดด้านล่างสำหรับทดสอบและไม่ใช่จากที่อยู่ที่ปารีสก่อนหน้า

{
  "name": "transit_nearby",
  "arguments": {
    "lat": 44.8416106,
    "lon": -0.5810938,
    "radius": 600,
    "modes": ["bus", "tram"],
    "limit": 10
  }
}

อ่านผลลัพธ์ก่อนสรุป

ตรวจสอบสถานะ เอนทิตีที่ส่งกลับ ขอบเขต คำเตือน และข้อจำกัดที่ใช้ คำตอบบางส่วนอาจมีข้อมูลที่ใช้ได้ การค้นหาไม่เจอไม่ได้แปลว่าไม่มีการขนส่งในเมือง

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

แก้ไขข้อผิดพลาดการเชื่อมต่อ

แยกแยะผลลัพธ์ว่างจากข้อผิดพลาด API

สร้างผู้ช่วยเต็มรูปแบบจากที่อยู่

เข้าใจบทบาทของเซิร์ฟเวอร์ MCP

กำลังจะมา: เวลารถออกถัดไปและคำนวณเส้นทาง

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

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

จำเป็นต้องมีโทเค็นไหม?

เอกสารมีการเข้าถึงแบบไม่ระบุตัวตน Free ขีดจำกัดและความสามารถขึ้นอยู่กับบริการที่ใช้งาน

ทำไมผู้ช่วยของฉันแสดงเวลาหลังค้นหาป้าย?

การค้นหา transit_nearby ไม่ให้เวลารถออกถัดไป ขอให้ผู้ช่วยแสดงข้อมูลที่คืนจริงและแจ้งว่าไม่มีข้อมูลนั้น

สามารถทดสอบโดยไม่สร้างแอปได้ไหม?

ได้ โดยใช้ไคลเอนต์ที่รองรับการเพิ่มเซิร์ฟเวอร์ระยะไกลและเรียกใช้เครื่องมือ