บทนำ
ผมเคยเจอปัญหา **"ConnectionError: timeout after 30000ms"** เมื่อพยายามตั้งค่า MCP server สำหรับ Claude Desktopบน Debian 12 เพราะไม่มี documentation ที่ละเอียดเพียงพอสำหรับ Linux โดยเฉพาะ วันนี้ผมจะมาแชร์ขั้นตอนทั้งหมดที่ทำให้ติดตั้งสำเร็จ ในบทความนี้เราจะใช้ [HolySheep AI](https://www.holysheep.ai/register) ซึ่งมีราคาถูกกว่า 85% เมื่อเทียบกับ API ทั่วไป (อัตรา ¥1=$1) รองรับ WeChat/Alipay และมีความหน่วงต่ำกว่า 50msขั้นตอนที่ 1: ติดตั้ง dependencies ที่จำเป็น
# อัปเดต package list
sudo apt update && sudo apt upgrade -y
ติดตั้ง Node.js 20 LTS (จำเป็นสำหรับ MCP SDK)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
ตรวจสอบเวอร์ชัน
node --version # ควรได้ v20.x.x
npm --version # ควรได้ 10.x.x
ติดตั้ง Python และ pip
sudo apt install -y python3 python3-pip python3-venv
ขั้นตอนที่ 2: สร้าง MCP Server Project
# สร้างโฟลเดอร์สำหรับโปรเจกต์
mkdir -p ~/claude-mcp-server && cd ~/claude-mcp-server
สร้าง Node.js project
npm init -y
ติดตั้ง MCP SDK และ dependencies
npm install @modelcontextprotocol/sdk @anthropic-ai/sdk dotenv
ขั้นตอนที่ 3: สร้างไฟล์ MCP Server
// mcp-server.js
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
import Anthropic from '@anthropic-ai/sdk';
import 'dotenv/config';
const anthropic = new Anthropic({
baseURL: 'https://api.holysheep.ai/v1',
apiKey: process.env.ANTHROPIC_API_KEY,
});
const server = new Server(
{
name: 'claude-mcp-server',
version: '1.0.0',
},
{
capabilities: {
tools: {},
},
}
);
server.setRequestHandler(ListToolsRequestSchema, async () => {
return {
tools: [
{
name: 'chat',
description: 'ส่งข้อความไปยัง Claude AI',
inputSchema: {
type: 'object',
properties: {
message: { type: 'string', description: 'ข้อความที่ต้องการส่ง' },
system: { type: 'string', description: 'System prompt (optional)' },
},
required: ['message'],
},
},
],
};
});
server.setRequestHandler(CallToolRequestSchema, async (request) => {
const { name, arguments: args } = request.params;
if (name === 'chat') {
try {
const message = await anthropic.messages.create({
model: 'claude-sonnet-4-20250514',
max_tokens: 1024,
messages: [
{
role: 'user',
content: args.message,
},
],
system: args.system || 'คุณเป็นผู้ช่วยที่เป็นประโยชน์',
});
return {
content: [
{
type: 'text',
text: message.content[0].text,
},
],
};
} catch (error) {
return {
content: [
{
type: 'text',
text: เกิดข้อผิดพลาด: ${error.message},
},
],
isError: true,
};
}
}
throw new Error(ไม่รู้จัก tool: ${name});
});
const transport = new StdioServerTransport();
server.connect(transport);
ขั้นตอนที่ 4: สร้างไฟล์ Environment
# สร้างไฟล์ .env
cat > ~/.claude-mcp-server/.env << 'EOF'
ANTHROPIC_API_KEY=YOUR_HOLYSHEEP_API_KEY
EOF
กำหนดสิทธิ์ความปลอดภัย
chmod 600 ~/.claude-mcp-server/.env
ขั้นตอนที่ 5: ตั้งค่า Claude Desktop Config
# สร้างไฟล์ config สำหรับ Claude Desktop
mkdir -p ~/.config/Claude
cat > ~/.config/Claude/claude_desktop_config.json << 'EOF'
{
"mcpServers": {
"holysheep-mcp": {
"command": "node",
"args": [
"/home/YOUR_USERNAME/claude-mcp-server/mcp-server.js"
],
"env": {
"ANTHROPIC_API_KEY": "YOUR_HOLYSHEEP_API_KEY"
}
}
}
}
EOF
แทนที่ YOUR_USERNAME ด้วย username ของคุณ
USERNAME=$(whoami)
sed -i "s/YOUR_USERNAME/$USERNAME/g" ~/.config/Claude/claude_desktop_config.json
แทนที่ YOUR_HOLYSHEEP_API_KEY ด้วย API key จริงของคุณ
sed -i 's/YOUR_HOLYSHEEP_API_KEY/YOUR_HOLYSHEEP_API_KEY/g' ~/.config/Claude/claude_desktop_config.json
echo "Config ถูกสร้างที่ ~/.config/Claude/claude_desktop_config.json"
ขั้นตอนที่ 6: ทดสอบ MCP Server
# ทดสอบรัน MCP server แบบ manual
cd ~/claude-mcp-server
node mcp-server.js
หากได้ผลลัพธ์ประมาณนี้ แสดงว่าสำเร็จ:
{"jsonrpc":"2.0","id":0,"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"claude-mcp-server","version":"1.0.0"}}}
กด Ctrl+C เพื่อหยุด
ข้อผิดพลาดที่พบบ่อยและวิธีแก้ไข
- ข้อผิดพลาด: "401 Unauthorized"
สาเหตุ: API key ไม่ถูกต้องหรือหมดอายุ
วิธีแก้: ตรวจสอบว่าใช้ key จาก HolySheep AI และคัดลอกให้ถูกต้อง รวมถึงไม่มีช่องว่างเพิ่มเข้ามา
# วิธีตรวจสอบ API key cat ~/.claude-mcp-server/.envควรเห็น: ANTHROPIC_API_KEY=sk-... (key ที่ถูกต้อง)
ทดสอบ API key ด้วย curl
curl https://api.holysheep.ai/v1/models \ -H "Authorization: Bearer YOUR_HOLYSHEEP_API_KEY"หากได้ JSON response แสดงว่า key ถูกต้อง
- ข้อผิดพลาด: "ConnectionError: timeout after 30000ms"
สาเหตุ: Firewall หรือ network configuration บล็อกการเชื่อมต่อ
วิธีแก้: ตรวจสอบ iptables และ DNS settings
# ตรวจสอบ DNS cat /etc/resolv.confทดสอบเชื่อมต่อไปยัง HolySheep API
curl -v https://api.holysheep.ai/v1/models \ --connect-timeout 10หาก timeout ให้ลองใช้ Google DNS
sudo nano /etc/resolv.confเพิ่ม: nameserver 8.8.8.8
เพิ่ม: nameserver 8.8.4.4
- ข้อผิดพลาด: "Module not found: @modelcontextprotocol/sdk"
สาเหตุ: npm packages ไม่ได้ติดตั้งในโฟลเดอร์ที่ถูกต้อง
วิธีแก้: ติดตั้ง dependencies ใหม่ด้วยเวอร์ชันที่ถูกต้อง
# ลบ node_modules และ package-lock.json เดิม cd ~/claude-mcp-server rm -rf node_modules package-lock.jsonติดตั้งใหม่ด้วยเวอร์ชันที่ระบุ
npm install @modelcontextprotocol/[email protected] @anthropic-ai/[email protected] dotenvตรวจสอบการติดตั้ง
npm list --depth=0 - ข้อผิดพลาด: "Error: spawn node ENOENT"
สาเหตุ: Node.js ไม่ได้อยู่ใน PATH หรือ path ใน config ผิด
วิธีแก้: ตรวจสอบ path ของ node และใช้ full path
# หา path ของ node which nodeมักจะได้: /usr/bin/node
แก้ไข config โดยใช้ full path
cat > ~/.config/Claude/claude_desktop_config.json << 'EOF' { "mcpServers": { "holysheep-mcp": { "command": "/usr/bin/node", "args": ["/home/YOUR_USERNAME/claude-mcp-server/mcp-server.js"], "env": { "ANTHROPIC_API_KEY": "YOUR_HOLYSHEEP_API_KEY" } } } } EOF
ราคา API ของ HolySheep AI (2026)
- GPT-4.1: $8/MTok
- Claude Sonnet 4.5: $15/MTok
- Gemini 2.5 Flash: $2.50/MTok
- DeepSeek V3.2: $0.42/MTok
อัตราแลกเปลี่ยนพิเศษ: ¥1 = $1 ประหยัดได้มากกว่า 85% เมื่อเทียบกับราคาปกติ รองรับ WeChat และ Alipay มีความหน่วงต่ำกว่า 50ms
สรุป
การติดตั้ง MCP Server สำหรับ Claude Desktop บน Debian 12 ไม่ใช่เรื่องยากหากรู้ขั้นตอนที่ถูกต้อง ประเด็นสำคัญคือการใช้ API ที่ถูกต้อง (ใช้ https://api.holysheep.ai/v1 ไม่ใช่ api.anthropic.com) และการตั้งค่า environment variables ให้ถูกต้อง
หากพบปัญหาใด ๆ ในการติดตั้ง สามารถดูรายละเอียดข้อผิดพลาดข้างต้นหรือติดต่อ support ของ HolySheep AI ได้โดยตรง
👉 สมัคร HolySheep AI — รับเครดิตฟรีเมื่อลงทะเบียน