ถ้า MCP ใน Claude Code ใช้ไม่ได้ ให้เริ่มจากรัน claude mcp list แล้วดูสถานะ "✘ Failed to connect" มักมาจาก transport หรือ URL ผิด "! Needs authentication" แก้ด้วย /mcp เพื่อ login ส่วน redirect_uri_mismatch แปลว่า redirect URI ใน OAuth app ไม่ตรงกับ http://localhost:PORT/callback ที่ Claude Code ส่ง ถ้าต่อได้แต่เรียก tool ไม่ได้ ปัญหามักอยู่ที่สิทธิ์ของบัญชีหรือ scope และถ้าไม่เห็น tools ให้เช็กจำนวน tool ใน /mcp ก่อน เพราะ Claude Code โหลด tool แบบ on demand (ข้อมูล ณ 9 พ.ย. 2026)
บทความนี้รวม error ของ MCP ที่เจอบ่อยใน Claude Code แยกตามอาการ ทุกข้อมาจากเอกสาร MCP และหน้า error reference ของ Claude Code เอง ถ้าคุณมาจาก error "The caller does not have permission" ของ Google Workspace ให้อ่าน
บทความเฉพาะเรื่องนั้นได้เลย
Claude Code MCP ใช้ไม่ได้ เริ่มเช็กจากตรงไหน?
เริ่มจากคำสั่งเดียว claude mcp list จะแสดงสถานะของทุก server ที่ตั้งไว้ ส่วน claude mcp get ตามด้วยชื่อ server จะบอกรายละเอียด error ในบรรทัด Issue
claude mcp list
claude mcp get <name>สถานะที่เห็น | ความหมาย | ทำอะไรต่อ |
|---|---|---|
✔ Connected | ต่อได้แล้ว | ถ้ายังใช้ไม่ได้ ให้ดูหัวข้อ "ต่อได้แต่ไม่เห็น tools" |
! Needs authentication | server ต้องการ login (ได้ 401 หรือ 403) | รัน /mcp ใน Claude Code หรือ claude mcp login ตามด้วยชื่อ server |
✘ Failed to connect | ต่อไม่ติด | ดูรายละเอียดด้วย claude mcp get แล้วเช็ก URL, transport และ token |
⏸ Pending approval | server จาก .mcp.json ของ project ที่ยังไม่ได้อนุมัติ | รัน claude ในโฟลเดอร์นั้นแล้วกดอนุมัติ |
⊘ Disabled for this project | ถูกปิดไว้สำหรับ project นี้ | เปิดกลับได้ใน /mcp |
✘ Blocked by enterprise managed policy | policy ขององค์กรไม่อนุญาต server นี้ | ถาม admin ว่า policy ไหนบล็อกไว้ แก้จากฝั่งเราไม่ได้ |
not configured | url ว่าง | ใส่ url ให้ server นั้น |
ถ้ามีหลาย server ที่ล้ม รัน /mcp reconnect all ใน Claude Code เพื่อลองต่อใหม่ทั้งหมด (ต้องใช้ v2.1.284 ขึ้นไป) ส่วน server แบบ remote ที่ขึ้นว่า cached … connects on first use ใน /mcp ไม่ใช่ error แต่ Claude Code โหลดรายชื่อ tool จาก cache ของ session ก่อน แล้วจะต่อจริงตอนเรียก tool ครั้งแรก
claude mcp add ควรใช้ transport ไหน และพลาดตรงไหนบ่อย?
Transport | ใช้เมื่อ | วิธีเพิ่ม |
|---|---|---|
HTTP | server แบบ remote (แนะนำ) | claude mcp add --transport http ชื่อ URL |
SSE | server เก่าที่มีแค่ SSE (deprecated แล้ว) | ใช้ --transport http ได้เลย เพราะตั้งแต่ v2.1.265 Claude Code จะลอง HTTP ก่อนแล้วสลับเป็น SSE ให้เอง |
stdio | โปรแกรมที่รันบนเครื่องเรา เช่น npx | claude mcp add ชื่อ -- คำสั่ง |
WebSocket | URL ที่ขึ้นต้นด้วย wss:// | ต้องใช้ claude mcp add-json เพราะ --transport ไม่รับ ws |
# remote server
claude mcp add --transport http notion https://mcp.notion.com/mcp
# local server: ทุกอย่างหลัง -- ส่งให้ server ตรงๆ
claude mcp add --env AIRTABLE_API_KEY=<KEY> --transport stdio airtable -- npx -y airtable-mcp-serverจุดที่พลาดบ่อย:
- ลืม --
ตอนเพิ่ม stdio server ถ้าไม่มี -- แฟล็กอย่าง -y จะถูก Claude Code อ่านเป็นของตัวเอง
- ชื่อ server ต่อท้าย --env ทันที
CLI จะอ่านชื่อนั้นเป็นตัวแปรอีกตัวแล้ว error ให้มีแฟล็กอื่นคั่น เช่น --transport stdio
- ก๊อป JSON จาก client อื่นแล้วมีแต่ url ไม่มี type
Claude Code จะอ่านเป็น stdio แล้วข้าม server นั้น ให้เพิ่ม "type": "http" (หรือ sse, ws)
- ชื่อ server มีช่องว่างหรือจุด
ชื่อใช้ได้แค่ตัวอักษร ตัวเลข ขีดกลางและขีดล่าง ปัญหานี้เจอบ่อยตอน import จาก Claude Desktop ด้วย claude mcp add-from-claude-desktop
- ใช้ชื่อที่ระบบจองไว้
เช่น workspace หรือ computer-use Claude Code จะไม่โหลด server นั้น
เพิ่ม server แล้วแต่หาไม่เจอ เป็นเพราะ scope หรือเปล่า?
เป็นสาเหตุที่เจอบ่อยมาก ค่าเริ่มต้นของ claude mcp add คือ scope
localซึ่งใช้ได้เฉพาะ project ที่เพิ่ม ถ้าเปิด Claude Code ในโฟลเดอร์อื่นจะไม่เห็น server นั้น
Scope | ใช้ได้ที่ไหน | แชร์กับทีม | เก็บไว้ที่ |
|---|---|---|---|
local (ค่าเริ่มต้น) | project ปัจจุบันเท่านั้น | ไม่ | ~/.claude.json ใต้ path ของ project |
project | project ปัจจุบัน | ได้ ผ่าน git | .mcp.json ที่ root ของ project |
user | ทุก project ของเรา | ไม่ | ~/.claude.json |
อยากใช้ทุก project ให้เพิ่มด้วย --scope user
ถ้าชื่อเดียวกันอยู่หลาย scope Claude Code จะเลือกตามลำดับ local, project, user, plugin แล้วจึงเป็น claude.ai connector และใช้ทั้ง entry จากที่เดียว ไม่เอามารวมกัน
server ใน .mcp.json ต้องอนุมัติก่อนใช้ ถ้าเคยกดปฏิเสธไปแล้ว รีเซ็ตได้ด้วย claude mcp reset-project-choices
OAuth ไม่ผ่าน: redirect_uri_mismatch, dynamic client registration และ callback port
Server แบบ remote ส่วนใหญ่ใช้ OAuth ปกติแค่รัน /mcp แล้ว login ใน browser แต่ server บางตัว (เช่น Google Workspace MCP) ไม่รองรับการลงทะเบียน client อัตโนมัติ เราต้องสร้าง OAuth app เองแล้วส่ง client ID เข้าไป
claude mcp add --transport http \
--client-id <CLIENT_ID> --client-secret --callback-port <PORT> \
my-server https://mcp.example.com/mcpError | สาเหตุ | วิธีแก้ |
|---|---|---|
Incompatible auth server: does not support dynamic client registration | server ไม่ให้ Claude Code ลงทะเบียน client เอง | สร้าง OAuth app ใน developer portal ของ server แล้วเพิ่มใหม่ด้วย --client-id, --client-secret และ --callback-port |
redirect_uri_mismatch หรือ redirect URI mismatch (ข้อความจากหน้า login ของ server) | redirect URI ที่ลงทะเบียนไม่ตรงกับ http://localhost:PORT/callback | ใส่ URI ให้ตรงทุกตัวอักษรและใช้ PORT เดียวกับ --callback-port ถ้าใช้ v2.1.229 ให้อัปเดต เพราะเวอร์ชันนั้นส่ง 127.0.0.1 แทน localhost (แก้แล้วใน v2.1.231) |
OAuth callback port … is already in use | มีโปรแกรมอื่นจองพอร์ตอยู่ | หาโปรแกรมด้วย lsof ตามที่ข้อความบอก หรือเปลี่ยนพอร์ตทั้งใน OAuth app และ --callback-port |
No available ports for OAuth redirect | security software หรือ sandbox ห้ามเปิดพอร์ตบน 127.0.0.1 | อนุญาตให้ Claude Code เปิดพอร์ต local แล้ว login ใหม่ |
browser redirect ล้มหลัง login | browser ส่ง callback กลับมาไม่ถึง | ก๊อป URL เต็มจาก address bar ไปวางในช่องที่ Claude Code ถาม |
เรื่อง client secret: ใส่ --client-secret ไว้เฉยๆ Claude Code จะถามแบบซ่อนตัวอักษรและเก็บไว้ใน keychain
ตั้ง secret ได้เฉพาะตอนเพิ่ม server เท่านั้นถ้าใส่ผิดหรืออยากเปลี่ยน ต้องรัน claude mcp remove แล้วเพิ่มใหม่ด้วย --scope เดิม
ต่อได้ login แล้ว แต่เรียก tool แล้วขึ้น permission error ทำยังไง?
ข้อความ | สาเหตุ | วิธีแก้ |
|---|---|---|
MCP server "…" needs you to sign in again | token หมดอายุหรือถูกยกเลิก | รัน /mcp เลือก server แล้ว login ใหม่ |
MCP server "…" needs additional permissions (scope: "…") | token ไม่มี scope ที่ tool ต้องการ | login ใหม่ผ่าน /mcp ถ้าตั้ง oauth.scopes ไว้เอง ต้องเพิ่ม scope นั้นก่อน ไม่งั้นจะได้ token เดิม |
server ตอบ 401 หรือ 403 แต่ไม่มีให้ login | ตั้ง header Authorization ไว้เองใน config | Claude Code จะไม่สลับไปใช้ OAuth ให้แก้ token หรือลบ header ออก |
The caller does not have permission (Google Workspace MCP) | บัญชีหรือ project ยังไม่ได้เข้า Developer Preview หรือ OAuth client ยังไม่ได้ตั้งเป็น AI agent |
อาการแบบสุดท้ายหลอกตาที่สุด เพราะ claude mcp list ขึ้น ✔ Connected และเห็นรายชื่อ tools ครบ แต่ server ฝั่ง Google ปฏิเสธทุกการเรียกใช้ ปัญหาจึงอยู่ที่สิทธิ์ของบัญชี ไม่ใช่ Claude Code
ถ้าเจอ 403 จาก MCP ของ Google Analytics ดูวิธีตั้งค่าและแก้ได้ใน
บทความเชื่อม Google Analytics MCP กับ Claude Codeต่อได้แต่ไม่เห็น tools หรือ Claude บอกว่าไม่มี tool นั้น?
- 1.เช็กจำนวน tool ใน /mcp ก่อน
panel นี้แสดงจำนวน tool ของแต่ละ server และจะบอกถ้า server ประกาศว่ามี tools แต่ไม่ส่งมาสักตัว กรณีนั้นปัญหาอยู่ที่ server
- 2.Tool search เปิดอยู่เป็นค่าเริ่มต้น
Claude Code โหลดแค่ชื่อ tool ตอนเริ่ม แล้วค่อยดึงรายละเอียดตอนต้องใช้ จึงไม่ได้แปลว่า tool หายไป ถ้าอยากให้ server ไหนโหลด tool ตั้งแต่แรก ให้ตั้ง alwaysLoad เป็น true ใน config ของ server นั้น
- 3.Tool บางตัวถูกตัดออก
Claude Code จะไม่ส่ง tool ที่ชื่อเต็ม (mcp__server__tool) ยาวเกิน 128 ตัวอักษร หรือ tool ที่ input schema ไม่ผ่านการตรวจ เพื่อไม่ให้ทั้ง request พัง ตั้งชื่อ server ให้สั้นลงช่วยได้ในกรณีแรก
- 4.ใช้ผ่าน LLM gateway
ถ้าตั้ง ANTHROPIC_BASE_URL ไปที่ gateway (เช่น
9Router) Claude Code จะส่ง field ของ tool search ไปด้วย ถ้า gateway ของคุณไม่รองรับ field เหล่านี้จะเจอ API Error: 400 … Extra inputs are not permitted ที่พูดถึง defer_loading หรือ tool_reference ให้อัปเดตเป็น v2.1.305 ขึ้นไป (จะลองใหม่โดยไม่ใช้ tool search ให้เอง) หรือตั้ง ENABLE_TOOL_SEARCH=false
- 5.Server เริ่มช้า
ค่าเริ่มต้นรอ 30 วินาที ปรับได้ด้วย MCP_TIMEOUT เช่น MCP_TIMEOUT=60000

claude.ai, Claude Code และ Antigravity ต่อ MCP ต่างกันยังไง?
Claude Code | claude.ai (custom connector) | Antigravity | |
|---|---|---|---|
ตั้งค่าที่ไหน | claude mcp add หรือ .mcp.json | Customize > Connectors | ~/.gemini/config/mcp_config.json |
Redirect URI สำหรับ OAuth app ของเราเอง | http://localhost:PORT/callback | https://claude.ai/api/mcp/auth_callback | https://antigravity.google/oauth-callback |
ใครเพิ่มได้ | ตัวเราเอง | Free (ได้ 1 ตัว), Pro, Max และ Ultra เพิ่มเองได้ ส่วน Team และ Enterprise ต้องให้ Owner ขององค์กรเพิ่ม | ตัวเราเอง หรือ admin กำหนดให้ในองค์กร |
ถ้า login Claude Code ด้วยบัญชี claude.ai connector ที่เพิ่มไว้บน claude.ai จะขึ้นใน /mcp อัตโนมัติ แต่จะ
ไม่ถูกโหลดถ้า Claude Code ใช้ ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN หรือ apiKeyHelper อยู่ ถ้า gateway ของคุณให้ตั้งตัวแปรพวกนี้ (เช่น ANTHROPIC_AUTH_TOKEN) ก็เข้าเงื่อนไขนี้ด้วย ใช้ /status เช็กว่าตอนนี้ login แบบไหน
อีกกรณีที่ควรรู้: connector ที่ Anthropic host เอง เช่น Gmail และ Google Calendar ของ claude.ai ใช้ OAuth จากเครื่องเราไม่ได้ ถ้าเพิ่ม URL ของ connector พวกนี้ด้วย claude mcp add จะได้ข้อความ "is Anthropic-hosted and doesn't support local OAuth" วิธีแก้คือลบ server นั้นออก แล้วไปเชื่อมบน claude.ai แทน connector จะตามมาใน Claude Code เอง (กรณีนี้ต่างจาก MCP ทางการของ Google ที่บทความ Workspace MCP พูดถึง ซึ่งใช้ OAuth app ของเราเอง)
ฝั่ง Antigravity ถ้าองค์กรบังคับ policy ของ Gemini Enterprise อาจเจอ "Unauthorized / Blocked by Admin Policy" ซึ่งต้องให้ admin เพิ่ม endpoint เข้า allow-list
FAQ
claude mcp list ขึ้น Failed to connect ต้องทำอะไรก่อน
รัน claude mcp get ตามด้วยชื่อ server แล้วดูบรรทัด Issue ซึ่งบอก HTTP status หรือ error code จาก server จากนั้นเช็กสามจุด: URL ถูกไหม, transport ตรงกับ server ไหม (remote ใช้ http, wss ใช้ add-json) และถ้าก๊อป JSON มาจาก client อื่น มี "type" หรือยัง สำหรับ stdio ให้ลองรันคำสั่งหลัง -- เองใน terminal
อยากเปลี่ยน client secret ต้องทำยังไง
Claude Code รับ client secret ได้เฉพาะตอนเพิ่ม server และเก็บไว้ใน keychain ไม่ใช่ในไฟล์ config การ login ใหม่ผ่าน /mcp จะใช้ secret เดิมเสมอ ถ้าจะเปลี่ยนให้รัน claude mcp remove แล้วเพิ่มใหม่ด้วย --client-secret และ --scope เดิม การลบ server จะลบ token ที่เก็บไว้ไปด้วย
ทำไม connector จาก claude.ai ไม่ขึ้นใน Claude Code
Connector จะถูกดึงมาเฉพาะตอนที่ Claude Code login ด้วยบัญชี claude.ai ถ้ามี ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN หรือ apiKeyHelper ทำงานอยู่ หรือใช้ Bedrock หรือ Agent Platform หรือใช้ token จาก claude setup-token connector จะไม่ถูกโหลด รัน /status เพื่อดูวิธี login ที่ใช้อยู่ แล้ว /login ด้วยบัญชี claude.ai
ใช้ MCP ตอนที่ Claude Code วิ่งผ่าน gateway อย่าง 9Router ได้ไหม
เอกสารของ Claude Code บอกเงื่อนไขไว้สองข้อ ซึ่งขึ้นกับว่า gateway ของคุณทำงานยังไง (เรายังไม่ได้ทดสอบกับ 9Router โดยตรง) ข้อแรก ถ้า gateway ให้ตั้ง ANTHROPIC_AUTH_TOKEN หรือ ANTHROPIC_API_KEY connector จาก claude.ai จะไม่ถูกโหลด ส่วน server ที่เพิ่มเองด้วย claude mcp add ไม่ได้อยู่ในเงื่อนไขนี้ ข้อสอง ถ้า gateway ไม่รองรับ field ของ tool search จะเจอ error 400 ให้อัปเดต Claude Code หรือตั้ง ENABLE_TOOL_SEARCH=false
MCP กับ skill ต่างกันยังไง
MCP server ให้ tools ใหม่ที่ไปคุยกับระบบภายนอก เช่น Drive หรือ GitHub ส่วน skill เป็นไฟล์ SKILL.md ที่บอก Claude ว่าจะทำงานแบบไหน และโหลดเฉพาะตอนใช้ skill ไม่ต้อง login หรือต่อ server ถ้าอยากเห็นตัวอย่าง skill จริง ดู
Twintailที่เปลี่ยนบุคลิกของ Claude Code ด้วย skill ตัวเดียว
Server ใช้เวลาเริ่มนานจนหลุด แก้ยังไง
ค่าเริ่มต้น Claude Code รอ server เริ่มทำงาน 30 วินาที ถ้าเกินจะถือว่าล้ม ปรับได้ด้วย MCP_TIMEOUT เป็นมิลลิวินาที เช่น MCP_TIMEOUT=60000 claude ส่วน tool ที่รันนาน ตั้ง timeout ราย server ใน config หรือ MCP_TOOL_TIMEOUT ได้ ถ้า server remote หลุดกลางทาง Claude Code จะลองต่อใหม่เองห้าครั้งก่อนแจ้ง
สรุป
MCP ใน Claude Code ส่วนใหญ่แก้ได้ด้วยการอ่านสถานะให้ถูก: ใช้ claude mcp list ดูว่าล้มตรงไหน ใช้ claude mcp get ดูรายละเอียด แล้วไล่ตามอาการ ตั้งแต่ transport และ scope, OAuth และ redirect URI ไปจนถึงสิทธิ์ของบัญชีและ tool search เวอร์ชันของ Claude Code เปลี่ยนเร็ว ถ้าเจอ error ที่ไม่มีในบทความนี้ ให้ค้นข้อความเต็มในหน้า error reference ของ Claude Code
บทความที่เกี่ยวข้อง:
Last verified: 9 พ.ย. 2026, Claude Code 2.1.319 และเอกสาร MCP, error reference และ environment variables ของ Claude Code ฉบับวันเดียวกัน
แหล่งอ้างอิง:


