คู่มือการใช้งาน

จากเริ่มต้นสู่การเชื่อมต่อ

คู่มือใช้งานจริงสำหรับตั้งค่า Local MCP Workspace ตรวจสอบทั้งเส้นทาง เปิด Secure Tunnel และวิเคราะห์ปัญหาที่พบบ่อย

ติดตั้งและเตรียมเครื่อง

แอปเดสก์ท็อปจัดการชั้นการทำงาน แต่ Local MCP Runtime ที่แอปจะเปิดยังต้องติดตั้งอยู่บนเครื่อง

ติดตั้ง Tunnel Managerใช้ Windows Installer ที่ลงนามแล้วเมื่อ Stable Release พร้อม หน้า Landing และ Release Endpoint จะใช้ Version Metadata ชุดเดียวกัน

เตรียม MCP Runtimeติดตั้ง Runtime ที่ MCP Server เป้าหมายต้องใช้ สำหรับ Project ที่ใช้ Serena ให้ตรวจว่า Environment ของ Tunnel Manager สามารถเรียกคำสั่ง Serena ได้

เก็บ Project ไว้ใน LocalSource Project ยังคงอยู่บนเครื่อง Tunnel Manager เพียงประสาน Local MCP Process และการเชื่อมต่อ Secure Tunnel

สร้าง Profile

Profile คือชุดนิยามการเชื่อมต่อที่นำกลับมาใช้ได้สำหรับ MCP Workspace หนึ่งชุด ควรใช้หนึ่ง Profile ต่อหนึ่งคู่ Project/Runtime เพื่อให้ Validation และ Runtime State ชัดเจน

ข้อมูล Profile ที่แนะนำ

Project FolderLocal Workspace ที่ MCP Server จะทำงานด้วย

คำสั่ง MCP Targetคำสั่งที่ Tunnel Manager จะเปิด เช่น Serena MCP Server สำหรับ Project ที่เลือก

Tunnel Identity และ Runtime Keyใช้ค่าที่ออกให้สำหรับ OpenAI Secure Tunnel Workflow และเก็บค่าที่สำคัญไว้เฉพาะใน Local Control Layer

อย่าสร้าง Profile ซ้ำเพียงเพราะโหลด Key ไม่สำเร็จ ให้แก้ Credential ที่เก็บไว้แล้ว Validate Profile เดิมอีกครั้ง

Validate ก่อน Start

ควรใช้ Validation เป็นขั้นตอน Preflight ที่จำเป็น Profile ที่พร้อมต้องผ่าน Configuration, Credential, Tunnel Identity, MCP Target และ Local Runtime ก่อนที่ปุ่ม Start จะเปิดใช้งาน

Profile configuration    PASS Runtime API key          PASS Tunnel ID                PASS MCP target               PASS Local runtime            READY

ถ้ามี Process กำลังรัน ปุ่มที่รู้สถานะควรป้องกันการ Start ซ้ำ ให้ Stop หรือ Restart Process เดิมแทน

เชื่อม ChatGPT

เมื่อ Validation ผ่าน ให้ Start Profile จากนั้น Tunnel Manager จะเปิด Local MCP Process ที่ตั้งค่าไว้ สร้าง Secure Tunnel และแสดงสถานะการเชื่อมต่อบน Desktop UI

Start Profile ที่ผ่าน Validationรอจน MCP Runtime และ Tunnel แสดงสถานะทำงานปกติ

เปิด ChatGPT Connector Settingsเลือกหรือเชื่อม MCP Connector ที่ผูกกับ Tunnel ใหม่

ติดตามกิจกรรม AIเมื่อ ChatGPT เรียก Local MCP Tool ตัว Manager ควรเปลี่ยนจาก Connected/Standby เป็น AI Active และ Stream Runtime Log ที่เกี่ยวข้อง

ตั้งค่า Serena Project

สำหรับ Project ที่ใช้ Serena ให้เก็บพฤติกรรมระดับ Project ไว้ใน .serena และเก็บ Override เฉพาะเครื่องไว้ใน project.local.yml.

.serena/ ├── project.yml          # versioned project configuration └── project.local.yml    # machine-specific overrides

ข้อกำหนด Trusted Project

Serena จะรัน Project activation_command เมื่อ Project Path ถูก Trust ใน Serena Global Configuration ควร Trust เฉพาะ Path ของ Project หรือ Development Directory ที่จำกัด แทนการใช้กฎแบบ Global ** rule.

trusted_project_path_patterns: - /home/your-user/dev/your-project

แก้ไขปัญหา

เริ่มจากสถานะ Validation ที่มองเห็น แล้วตรวจ Streaming Log ปัญหามักอยู่ในชั้นใดชั้นหนึ่งของเส้นทาง

API Key หายหรือซ้ำ

ยืนยันว่า Profile โหลด Key ที่บันทึกไว้อยู่แล้วก่อนเพิ่ม Key ใหม่ และ Validate ใหม่หลังแก้ Credential ทุกครั้ง

Tunnel ID ไม่ถูกต้อง

ตรวจว่า Tunnel อยู่ใน Environment ที่ต้องการ และ Profile ไม่ได้นำ Identifier เก่ากลับมาใช้

ไม่พบ Workspace

ตรวจว่า Project Folder มีอยู่บนเครื่องที่ MCP Runtime รันจริง Remote Linux Workspace ต้องใช้ Path ที่ถูกต้องบน Linux Host นั้น

ไม่ได้ติดตั้ง Serena หรือไม่พบคำสั่ง

ลองรัน MCP Target ที่ตั้งค่าไว้ด้วย User Environment เดียวกัน แก้ PATH/Runtime ให้ถูกต้องก่อนลอง Tunnel Manager ใหม่

Project ยังไม่ Trusted

เพิ่ม Project Path ที่ตรงกันใน Serena Global trusted_project_path_patterns, จากนั้น Restart Serena/Tunnel Process เพื่อโหลด Global Configuration ใหม่

Port ถูกใช้งานอยู่

ระบุ Process ที่ใช้งานอยู่ก่อน หลีกเลี่ยงการเปิด Server ซ้ำ ให้ใช้ Process ที่ปกติอยู่แล้ว หรือ Stop Process เก่าแล้ว Restart Profile

Tunnel หลุดการเชื่อมต่อ

ตรวจ Local Network, Credential ของ Profile และสถานะ Tunnel หากเปิด Auto Recovery ให้ดู Live Log ว่าการ Reconnect กำลังดำเนินอยู่หรือไม่

ปุ่มไม่สามารถใช้งานได้

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