การเชื่อมต่อ Agent

มอบทางเชื่อมที่เชื่อถือได้จาก Agent สู่ MarkNest

ใช้ Skill แบบพกพาหรือเครื่องมือ MCP แบบมีโครงสร้างบน Public V1 API ที่กำหนดขอบเขตสิทธิ์เดียวกัน

ดาวน์โหลด Skill ดูวิธีตั้งค่า

Shell agent

MarkNest Skill

MCP client

MCP server

Shared contract

Public V1 API

MarkNest

Knowledge workspace

Bearer auth Scoped abilities Normalized errors

สองตัวเชื่อม หนึ่ง สัญญา

เลือกอินเทอร์เฟซที่ Agent ของคุณเข้าใจอยู่แล้ว พฤติกรรม API และโมเดลสิทธิ์ยังคงเหมือนกัน

สำหรับ Agent ที่รัน shell ได้

Agent Skill

ชุดคำสั่งแบบพกพาพร้อม CLI ในตัว ให้ Agent มีเวิร์กโฟลว์ กฎความปลอดภัย และเข้าถึง Public V1 API โดยตรงโดยไม่ต้องใช้ MCP runtime

เหมาะกับ Codex, Claude Code, OpenCode และ Agent อื่นที่รันคำสั่งในเครื่องได้

ดาวน์โหลด Skill 0.2.0 SHA-256 checksum

สำหรับไคลเอนต์ MCP

เซิร์ฟเวอร์ MCP

เซิร์ฟเวอร์ที่เผยแพร่แล้วมีเครื่องมือแบบมีโครงสร้างพร้อมตรวจสอบข้อมูลเข้า ไคลเอนต์ค้นพบคำสั่งและเรียกใช้ผ่าน MCP protocol

เหมาะกับผู้ช่วยบนเดสก์ท็อปและ Agent host ที่รองรับ MCP โดยตรง

แหล่งข้อมูลจริงเดียวกัน

ทั้งสองตัวเชื่อมใช้ Public V1 API client, bearer authentication, scoped abilities และรูปแบบข้อผิดพลาดเดียวกัน

เวิร์กโฟลว์ที่ Agent ทำได้ ครบถ้วน

เปลี่ยนผลการค้นคืนเป็นความรู้ถาวรโดยไม่ต้องสอน API ให้ Agent ทุกตัวใหม่

ค้นคืนพร้อมบริบท

ค้นหาเชิงความหมาย ตรวจ chunk ที่ตรง แล้วเปิดเอกสารต้นทางก่อนตอบ

เก็บผลลัพธ์ที่มีคุณค่า

บันทึกสรุปการประชุม โน้ตวิจัย หรือสรุป session เป็นฉบับร่างให้คนตรวจ

จัดความรู้ให้เป็นระเบียบ

สร้างโฟลเดอร์และแท็ก รวมรายการซ้ำ และวางเอกสารในจุดที่ค้นพบได้เสมอ

จัดการไฟล์และการแชร์อย่างรอบคอบ

อัปโหลดและดาวน์โหลดไฟล์ ตรวจสถานะการแชร์ และทำการเปลี่ยนแปลงสำคัญเมื่อมีคำขอชัดเจนเท่านั้น

ให้ Agent แนะนำการ ติดตั้ง

วาง Prompt สั้น ๆ ลงใน Agent เพื่อให้เลือกตัวเชื่อมที่เหมาะสมและแนะนำทีละขั้นโดยไม่เปิดเผยคีย์ API

ขอให้ Agent ติดตั้ง MarkNest

Prompt จะอ้างอิงคู่มือสำหรับเครื่องฉบับล่าสุด เพื่อให้หน้านี้กระชับแม้รายละเอียดการติดตั้งเปลี่ยนไป

Help me install MarkNest for this agent.

Read https://marknest.net/llms.txt and follow the Agent Integration guide...

แสดง Prompt ทั้งหมด

Help me install MarkNest for this agent.

Read https://marknest.net/llms.txt and follow the Agent Integration guide.
First determine whether this client supports Skills or MCP, then ask which operating system I use.
Guide me one step at a time. Keep my API key private, ask before changing configuration files, and finish with a read-only verification.

อ่านคู่มือ Agent

จากคีย์ API ถึง คำขอแรก

สร้างคีย์แบบกำหนดขอบเขต ติดตั้งตัวเชื่อมที่ตรงกับ Agent แล้วทดสอบอ่านจริงก่อนเปิดสิทธิ์เขียน

1

สร้างคีย์ API แบบกำหนดขอบเขต

เปิด Settings สร้างคีย์ API และให้เฉพาะ abilities ที่เวิร์กโฟลว์ต้องใช้
เปิดการตั้งค่าคีย์ API
2

ติดตั้งตัวเชื่อม

ดาวน์โหลดและตรวจสอบ Skill ZIP แล้วแตกโฟลเดอร์ marknest ไปยัง skill directory ของ Agent สำหรับ MCP ให้เพิ่ม npm server ใน client config
3

ตรวจสอบด้วยการอ่าน

เริ่มจากรายการเอกสารหรือค้นหาเชิงความหมาย เพิ่มสิทธิ์เขียนเมื่อเวิร์กโฟลว์ต้องใช้เท่านั้น

ติดตั้ง Skill bundle 0.2.0

curl -LO https://marknest.net/downloads/marknest-skill-0.2.0.zip
curl -LO https://marknest.net/downloads/marknest-skill-0.2.0.zip.sha256
shasum -a 256 -c marknest-skill-0.2.0.zip.sha256
unzip marknest-skill-0.2.0.zip -d <agent-skill-directory>

ตัวอย่าง Skill CLI Skill

export MARKNEST_API_KEY="mk_your_api_key"

node scripts/marknest.mjs search semantic \
  --query "launch notes"

node scripts/marknest.mjs documents create \
  --title "Launch recap" \
  --content "# Launch recap" \
  --status draft

การตั้งค่าไคลเอนต์ MCP MCP

{
  "mcpServers": {
    "marknest": {
      "command": "npx",
      "args": ["-y", "@marknest/mcp-server@0.2.0"],
      "env": {
        "MARKNEST_API_KEY": "mk_your_api_key"
      }
    }
  }
}

พร้อมใช้เป็นค่าเริ่มต้น ระวังเมื่อมี การเปลี่ยนแปลง

ชั้นเชื่อมต่อแยกการอ่านทั่วไปออกจากการเผยแพร่ เขียนทับ หรือลบความรู้

READ

อ่านอย่างปลอดภัย

ค้นหาและตรวจบริบทก่อนสรุปข้อเท็จจริงหรือเสนอการแก้ไข

DRAFT

เขียนเป็นฉบับร่าง

สรุปและโน้ตใหม่จะบันทึกเป็นฉบับร่างที่ตรวจได้เมื่อเวิร์กโฟลว์รองรับ

CONFIRM

ยืนยันการทำงานสำคัญ

การลบ การแชร์สาธารณะ และการอัปเดตที่คล้ายเขียนทับต้องมีเจตนาจากผู้ใช้ที่ชัดเจน

ให้ MarkNest เป็นส่วนหนึ่งของ Agent workflow

การเชื่อมต่อ Agent และคีย์ API แบบกำหนดขอบเขตมีในแพ็กเกจ Pro และ Max

ดาวน์โหลด Skill ดูการตั้งค่า MCP