{"title":"Xây dựng Client MCP tùy chỉnh","slug":"custom-client","category":"mcp","summary":"Kết nối đến Synapse MCP server từ ứng dụng riêng của bạn sử dụng MCP SDK.","audience":["human","llm"],"tags":["mcp","custom","sdk","development"],"difficulty":"advanced","updated":"2026-06-27","word_count":213,"read_minutes":1,"lang":"vi","translated":true,"requested_lang":"vi","content_markdown":"\n# Xây dựng Client MCP tùy chỉnh\n\nNếu bạn đang xây dựng ứng dụng LLM riêng, bạn có thể kết nối đến Synapse MCP\nserver trực tiếp sử dụng MCP SDK chính thức. Điều này cho phép ứng dụng của bạn\ntruy cập tất cả 79 công cụ Synapse.\n\n## SDK\n\n| Ngôn ngữ | Gói |\n|----------|---------|\n| TypeScript/JavaScript | `@modelcontextprotocol/sdk` |\n| Python | `mcp` |\n\n## Ví dụ TypeScript\n\n### Cài đặt\n\n```bash\nnpm install @modelcontextprotocol/sdk\n```\n\n### Kết nối qua stdio\n\n```typescript\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\n\nconst transport = new StdioClientTransport({\n command: \"npx\",\n args: [\"-y\", \"synapse-mcp-api@latest\"],\n env: {\n SYNAPSE_MIND_KEY: process.env.SYNAPSE_MIND_KEY!,\n SYNAPSE_URL: \"https://synapse.schaefer.zone\",\n },\n});\n\nconst client = new Client(\n { name: \"my-app\", version: \"1.0.0\" },\n { capabilities: {} }\n);\n\nawait client.connect(transport);\n\n// List all available tools\nconst { tools } = await client.listTools();\nconsole.log(`Available tools: ${tools.length}`);\nfor (const tool of tools) {\n console.log(`- ${tool.name}: ${tool.description}`);\n}\n\n// Call a tool\nconst result = await client.callTool({\n name: \"memory_recall\",\n arguments: {},\n});\nconsole.log(result.content);\n\n// Store a memory\nawait client.callTool({\n name: \"memory_store\",\n arguments: {\n category: \"fact\",\n key: \"custom_client_test\",\n content: \"Built a custom MCP client\",\n tags: [\"test\", \"mcp\"],\n priority: \"normal\",\n },\n});\n\nawait client.close();\n```\n\n### Kết nối qua HTTP/SSE (từ xa)\n\n```typescript\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\n\nconst transport = new SSEClientTransport(\n new URL(\"https://synapse-mcp.schaefer.zone/sse\"),\n {\n requestInit: {\n headers: {\n Authorization: `Bearer ${process.env.SYNAPSE_MIND_KEY}`,\n },\n },\n }\n);\n\nconst client = new Client(\n { name: \"my-app\", version: \"1.0.0\" },\n { capabilities: {} }\n);\n\nawait client.connect(transport);\n// ... use as above\n```\n\n## Ví dụ Python\n\n### Cài đặt\n\n```bash\npip install mcp\n```\n\n### Kết nối qua stdio\n\n```python\nfrom mcp import ClientSession, StdioServerParameters\nfrom mcp.client.stdio import stdio_client\n\nserver_params = StdioServerParameters(\n command=\"npx\",\n args=[\"-y\", \"synapse-mcp-api@latest\"],\n env={\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\",\n },\n)\n\nasync with stdio_client(server_params) as (read, write):\n async with ClientSession(read, write) as session:\n await session.initialize()\n\n # List tools\n tools = await session.list_tools()\n print(f\"Available tools: {len(tools.tools)}\")\n\n # Call a tool\n result = await session.call_tool(\"memory_recall\", {})\n print(result.content)\n\n # Store a memory\n await session.call_tool(\"memory_store\", {\n \"category\": \"fact\",\n \"key\": \"python_client_test\",\n \"content\": \"Built a Python MCP client\",\n \"tags\": [\"test\", \"mcp\", \"python\"],\n \"priority\": \"normal\",\n })\n```\n\n## Tool Profile\n\nKhi kết nối, bạn có thể yêu cầu tool profile cụ thể qua header\n`Mcp-Tool-Profile` (HTTP/SSE) hoặc biến môi trường `MCP_PROFILE` (stdio):\n\n```typescript\n// stdio: set env var\nenv: {\n SYNAPSE_MIND_KEY: \"mk_...\",\n MCP_PROFILE: \"minimal\", // 8 tools instead of 119\n}\n\n// HTTP/SSE: set header\nrequestInit: {\n headers: {\n Authorization: \"Bearer mk_...\",\n \"Mcp-Tool-Profile\": \"minimal\",\n },\n}\n```\n\n## Xử lý lỗi\n\n```typescript\ntry {\n const result = await client.callTool({ name: \"memory_recall\", arguments: {} });\n if (result.isError) {\n console.error(\"Tool error:\", result.content);\n } else {\n console.log(\"Success:\", result.content);\n }\n} catch (err) {\n console.error(\"MCP error:\", err);\n}\n```\n\n## Trường hợp sử dụng\n\n- **Trợ lý AI tùy chỉnh** — xây dựng agent riêng của bạn với bộ nhớ cố định\n- **Tự động hóa quy trình** — xâu chuỗi công cụ Synapse trong quy trình tùy chỉnh\n- **Pipeline dữ liệu** — trích xuất bộ nhớ, biến đổi, tải nơi khác\n- **Bảng điều khiển giám sát** — hiển thị thống kê bộ nhớ, lịch sử chat, tác vụ\n\n## Bước tiếp theo\n\n- [Đặc tả MCP](https://spec.modelcontextprotocol.io)\n- [Synapse MCP Repo](https://gitlab.com/schaefer-services/synapse-mcp)\n- [Tổng quan API](/docs/api/overview)\n","content_html":"

Xây dựng Client MCP tùy chỉnh

\n

Nếu bạn đang xây dựng ứng dụng LLM riêng, bạn có thể kết nối đến Synapse MCP\nserver trực tiếp sử dụng MCP SDK chính thức. Điều này cho phép ứng dụng của bạn\ntruy cập tất cả 79 công cụ Synapse.

\n

SDK

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Ngôn ngữGói
TypeScript/JavaScript@modelcontextprotocol/sdk
Pythonmcp
\n

Ví dụ TypeScript

\n

Cài đặt

\n
npm install @modelcontextprotocol/sdk

Kết nối qua stdio

\n
import { Client } from "@modelcontextprotocol/sdk/client/index.js";\nimport { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";\n\nconst transport = new StdioClientTransport({\n  command: "npx",\n  args: ["-y", "synapse-mcp-api@latest"],\n  env: {\n    SYNAPSE_MIND_KEY: process.env.SYNAPSE_MIND_KEY!,\n    SYNAPSE_URL: "https://synapse.schaefer.zone",\n  },\n});\n\nconst client = new Client(\n  { name: "my-app", version: "1.0.0" },\n  { capabilities: {} }\n);\n\nawait client.connect(transport);\n\n// List all available tools\nconst { tools } = await client.listTools();\nconsole.log(`Available tools: ${tools.length}`);\nfor (const tool of tools) {\n  console.log(`- ${tool.name}: ${tool.description}`);\n}\n\n// Call a tool\nconst result = await client.callTool({\n  name: "memory_recall",\n  arguments: {},\n});\nconsole.log(result.content);\n\n// Store a memory\nawait client.callTool({\n  name: "memory_store",\n  arguments: {\n    category: "fact",\n    key: "custom_client_test",\n    content: "Built a custom MCP client",\n    tags: ["test", "mcp"],\n    priority: "normal",\n  },\n});\n\nawait client.close();

Kết nối qua HTTP/SSE (từ xa)

\n
import { Client } from "@modelcontextprotocol/sdk/client/index.js";\nimport { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";\n\nconst transport = new SSEClientTransport(\n  new URL("https://synapse-mcp.schaefer.zone/sse"),\n  {\n    requestInit: {\n      headers: {\n        Authorization: `Bearer ${process.env.SYNAPSE_MIND_KEY}`,\n      },\n    },\n  }\n);\n\nconst client = new Client(\n  { name: "my-app", version: "1.0.0" },\n  { capabilities: {} }\n);\n\nawait client.connect(transport);\n// ... use as above

Ví dụ Python

\n

Cài đặt

\n
pip install mcp

Kết nối qua stdio

\n
from mcp import ClientSession, StdioServerParameters\nfrom mcp.client.stdio import stdio_client\n\nserver_params = StdioServerParameters(\n    command="npx",\n    args=["-y", "synapse-mcp-api@latest"],\n    env={\n        "SYNAPSE_MIND_KEY": "mk_YOUR_KEY",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone",\n    },\n)\n\nasync with stdio_client(server_params) as (read, write):\n    async with ClientSession(read, write) as session:\n        await session.initialize()\n\n        # List tools\n        tools = await session.list_tools()\n        print(f"Available tools: {len(tools.tools)}")\n\n        # Call a tool\n        result = await session.call_tool("memory_recall", {})\n        print(result.content)\n\n        # Store a memory\n        await session.call_tool("memory_store", {\n            "category": "fact",\n            "key": "python_client_test",\n            "content": "Built a Python MCP client",\n            "tags": ["test", "mcp", "python"],\n            "priority": "normal",\n        })

Tool Profile

\n

Khi kết nối, bạn có thể yêu cầu tool profile cụ thể qua header\nMcp-Tool-Profile (HTTP/SSE) hoặc biến môi trường MCP_PROFILE (stdio):

\n
// stdio: set env var\nenv: {\n  SYNAPSE_MIND_KEY: "mk_...",\n  MCP_PROFILE: "minimal",  // 8 tools instead of 119\n}\n\n// HTTP/SSE: set header\nrequestInit: {\n  headers: {\n    Authorization: "Bearer mk_...",\n    "Mcp-Tool-Profile": "minimal",\n  },\n}

Xử lý lỗi

\n
try {\n  const result = await client.callTool({ name: "memory_recall", arguments: {} });\n  if (result.isError) {\n    console.error("Tool error:", result.content);\n  } else {\n    console.log("Success:", result.content);\n  }\n} catch (err) {\n  console.error("MCP error:", err);\n}

Trường hợp sử dụng

\n\n

Bước tiếp theo

\n\n","urls":{"html":"/docs/mcp/custom-client","text":"/docs/mcp/custom-client?format=text","json":"/docs/mcp/custom-client?format=json","llm":"/docs/mcp/custom-client?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}