Guides

Connect your AI tools (MCP)เชื่อมต่อเครื่องมือ AI ของคุณ (MCP)

Cosmos exposes your on-device index through an MCP server. The onboarding wizard installs it into Claude Code, Cursor, Cline, Windsurf, and Gemini CLI automatically — or you can point each tool at the launcher by hand.Cosmos เปิดให้เข้าถึง index ที่อยู่บนเครื่องของคุณผ่าน MCP server ตัว onboarding wizard จะติดตั้งให้กับ Claude Code, Cursor, Cline, Windsurf และ Gemini CLI โดยอัตโนมัติ หรือคุณจะชี้แต่ละเครื่องมือไปที่ launcher ด้วยตัวเองก็ได้

Cosmos exposes your on-device memory and code index through an MCP server. The onboarding wizard installs it into every AI coding tool it detects, so most people never touch a config file. If you'd rather wire it manually, point each tool at the Cosmos launcher.

Automatic setup (recommended)

The onboarding wizard installs everything automatically. To run it again, open Integrations → AI Coding Tools and click connect for each tool. The wizard writes the correct MCP config to the right path for Claude Code, Cursor, Cline, Windsurf, and Gemini CLI.

Wire it by hand

All tools launch the same MCP server via this path:

bash

/Applications/Cosmos.app/Contents/Resources/start-mcp.sh

Claude Code

Add an .mcp.json file in any project to enable Cosmos for that project:

json

{
  "mcpServers": {
    "cosmos": {
      "command": "/Applications/Cosmos.app/Contents/Resources/start-mcp.sh"
    }
  }
}

Cursor, Cline, Windsurf, Gemini CLI

Each tool has its own MCP config file in its own location. The wizard writes the same launcher (start-mcp.sh) into the correct path for whichever tool you connect. To configure by hand, add a cosmos server entry pointing command at the launcher path above, using that tool's MCP config format.

Tools you get

Once connected, your AI gains these Cosmos tools:

find_relevant_code — symptom plus past-lesson recall in one round-trip.
code_remember_error / code_list_errors — the moat: your accumulated bug-and-fix lessons, recalled before the AI re-derives a fix.
code_skeleton / code_get_symbol — read structure and individual symbols without loading whole files.
code_callers / code_callees / code_uses — real call-graph edges, not string matches.
code_explain_project / code_diff / code_context_bundle — orientation, change review, and one-shot context.
brain_search / brain_remember / brain_session_context / brain_pattern_recall — personal notes, decisions, and conventions across sessions.

Why doesn't my AI see the cosmos server?

Restart the AI tool after the wizard installs the server — most tools only read MCP config at startup. Then verify the connection with /mcp, which should list a server named cosmos. If it still doesn't appear, re-run the wizard from Integrations → AI Coding Tools.

Cosmos เปิดให้เข้าถึง memory และ code index ที่อยู่บนเครื่องของคุณผ่าน MCP server ตัว onboarding wizard จะติดตั้งให้กับเครื่องมือ AI coding ทุกตัวที่ตรวจพบ ดังนั้นคนส่วนใหญ่จึงแทบไม่ต้องไปยุ่งกับไฟล์ config เลย หากคุณอยากตั้งค่าเองด้วยมือ ก็แค่ชี้แต่ละเครื่องมือไปที่ Cosmos launcher

ตั้งค่าอัตโนมัติ (แนะนำ)

ตัว onboarding wizard จะติดตั้งทุกอย่างให้อัตโนมัติ หากต้องการรันอีกครั้ง ให้เปิด Integrations → AI Coding Tools แล้วคลิก connect สำหรับแต่ละเครื่องมือ wizard จะเขียน MCP config ที่ถูกต้องไปยัง path ที่เหมาะสมสำหรับ Claude Code, Cursor, Cline, Windsurf และ Gemini CLI

ตั้งค่าเองด้วยมือ

เครื่องมือทุกตัวจะเรียกใช้ MCP server ตัวเดียวกันผ่าน path นี้:

bash

/Applications/Cosmos.app/Contents/Resources/start-mcp.sh

Claude Code

เพิ่มไฟล์ .mcp.json ใน project ใดก็ได้เพื่อเปิดใช้งาน Cosmos สำหรับ project นั้น:

json

{
  "mcpServers": {
    "cosmos": {
      "command": "/Applications/Cosmos.app/Contents/Resources/start-mcp.sh"
    }
  }
}

Cursor, Cline, Windsurf, Gemini CLI

เครื่องมือแต่ละตัวมีไฟล์ MCP config ของตัวเองอยู่ในตำแหน่งของมันเอง wizard จะเขียน launcher ตัวเดียวกัน (start-mcp.sh) ไปยัง path ที่ถูกต้องของเครื่องมือที่คุณเชื่อมต่อ หากต้องการตั้งค่าเองด้วยมือ ให้เพิ่ม entry สำหรับ server ชื่อ cosmos โดยชี้ command ไปที่ path ของ launcher ด้านบน ตามรูปแบบ MCP config ของเครื่องมือนั้น

เครื่องมือที่คุณจะได้รับ

เมื่อเชื่อมต่อแล้ว AI ของคุณจะได้เครื่องมือ Cosmos เหล่านี้:

find_relevant_code — รวมการค้นจากอาการ (symptom) เข้ากับการเรียกคืน past-lesson ในรอบเดียว
code_remember_error / code_list_errors — จุดแข็งที่ลอกเลียนได้ยาก: บทเรียน bug-and-fix ที่สะสมไว้ของคุณ ถูกเรียกคืนก่อนที่ AI จะ derive วิธีแก้ขึ้นมาใหม่
code_skeleton / code_get_symbol — อ่านโครงสร้างและ symbol แต่ละตัวได้โดยไม่ต้องโหลดทั้งไฟล์
code_callers / code_callees / code_uses — เส้นของ call graph จริง ไม่ใช่การ match แบบ string
code_explain_project / code_diff / code_context_bundle — ทำความเข้าใจภาพรวมโปรเจกต์ รีวิวความเปลี่ยนแปลง และดึง context ครบในครั้งเดียว
brain_search / brain_remember / brain_session_context / brain_pattern_recall — โน้ตส่วนตัว การตัดสินใจ และ convention ต่าง ๆ ข้ามหลาย session

ทำไม AI ของฉันถึงมองไม่เห็น cosmos server?

ให้รีสตาร์ทเครื่องมือ AI หลังจาก wizard ติดตั้ง server เสร็จ เพราะเครื่องมือส่วนใหญ่อ่าน MCP config แค่ตอนเริ่มทำงานเท่านั้น จากนั้นตรวจสอบการเชื่อมต่อด้วย /mcp ซึ่งควรจะแสดง server ชื่อ cosmos ออกมา หากยังไม่ปรากฏ ให้รัน wizard อีกครั้งจาก Integrations → AI Coding Tools

Last updated June 2, 2026อัปเดตล่าสุด June 2, 20262 min read

Atitechs EngineeringMaintainer

Edit this page on GitHubแก้ไขหน้านี้บน GitHub