{"id":3173,"date":"2026-11-19T08:17:37","date_gmt":"2026-11-19T01:17:37","guid":{"rendered":"https:\/\/komunitech.com\/blog\/?p=3173"},"modified":"2026-11-19T08:17:37","modified_gmt":"2026-11-19T01:17:37","slug":"cara-bikin-mcp-server-sendiri-dari-nol","status":"publish","type":"post","link":"https:\/\/komunitech.com\/blog\/tutorial\/cara-bikin-mcp-server-sendiri-dari-nol\/","title":{"rendered":"Cara Bikin MCP Server Sendiri dari Nol: Sampai Bisa Dipakai Claude Code dan OpenClaw"},"content":{"rendered":"<p><strong>TL;DR:<\/strong> Bikin MCP server sendiri itu satu file program kecil: daftarkan tool yang mau kamu kasih ke AI, pilih transportnya (stdio buat lokal), lalu sambungkan ke Claude Code atau OpenClaw. Tutorial ini memakai SDK resmi v2 yang berlaku per November 2026 \u2014 TypeScript lewat <code>@modelcontextprotocol\/server<\/code> atau Python lewat paket <code>mcp<\/code>.<\/p>\n<blockquote>\n<p><strong>\ud83d\udca1 Key Takeaway<\/strong><\/p>\n<ul>\n<li><strong>Satu server, semua client bisa pakai.<\/strong> Server yang kamu bangun sekali bisa dipakai Claude Code, OpenClaw, dan client MCP lain.<\/li>\n<li><strong>Pakai SDK v2, bukan tutorial 2025.<\/strong> TypeScript: paket <code>@modelcontextprotocol\/server<\/code> dengan <code>registerTool<\/code>; Python: kelas <code>MCPServer<\/code>, bukan <code>FastMCP<\/code>.<\/li>\n<li><strong>Spesifikasi yang berlaku: revisi 2026-07-28.<\/strong> Protokolnya stateless \u2014 tidak ada lagi handshake <code>initialize<\/code> dan session id.<\/li>\n<li><strong>Uji dulu di Inspector sebelum disambungkan ke client.<\/strong> MCP Inspector memanggil tool kamu tanpa AI, jadi kamu tahu servernya jalan sebelum Claude memakainya.<\/li>\n<li><strong>Paling sering bikin gagal: <code>console.log<\/code> di server stdio, path relatif, dan lupa build.<\/strong><\/li>\n<\/ul>\n<\/blockquote>\n<h2>Kenapa repot-repot bikin MCP server sendiri?<\/h2>\n<p>Bayangin kamu sudah nyaman pakai Claude Code atau OpenClaw. Suatu hari kamu kepikiran: enak banget kalau agent ini bisa baca folder catatan kerjaku, atau nyimpen hasil riset ke arsipku sendiri. Masalahnya, agent itu tidak tahu folder catatanmu ada di mana.<\/p>\n<p>Di sinilah MCP server bikinan sendiri masuk: satu program kecil yang memberi tahu agent apa saja kemampuan yang kamu sediakan, cara memanggilnya, dan datanya. Sekali jadi, semua client MCP bisa memakainya. Bedanya dengan server yang sudah jadi: server bikinanmu memberi kemampuan yang kamu butuhkan, ke data yang kamu punya, dengan batasan yang kamu atur sendiri.<\/p>\n<p>Tutorial ini membangun satu server dari nol sampai jalan: server catatan yang bisa menyimpan, mencari, dan menampilkan daftar catatan, plus satu template prompt buat merekap semuanya.<\/p>\n<h2>MCP server itu apa, singkat saja<\/h2>\n<p>Model Context Protocol, atau MCP, adalah standar terbuka yang mengatur cara aplikasi AI terhubung ke tools dan data di luar dirinya. Anthropic memperkenalkannya pada 25 November 2024, dan sejak 9 Desember 2025 protokol ini dikelola Agentic AI Foundation di bawah Linux Foundation. Penjelasan lengkap soal host, client, dan server sudah dibedah di <a href=\"https:\/\/komunitech.com\/blog\/ai-agent\/mcp-server-apa-itu-cara-kerja-ai-agent-2026\/\">pembedahan MCP Server dan alasan AI Agent membutuhkannya<\/a>.<\/p>\n<p>Server MCP mengekspos tiga primitif:<\/p>\n<table>\n<tbody>\n<tr>\n<th><strong>Primitif<\/strong><\/th>\n<th><strong>Siapa yang memutuskan<\/strong><\/th>\n<\/tr>\n<tr>\n<td>Tools<\/td>\n<td>Model \u2014 dia yang memilih memanggil<\/td>\n<\/tr>\n<tr>\n<td>Resources<\/td>\n<td>Aplikasi \u2014 data yang dimuat ke konteks<\/td>\n<\/tr>\n<tr>\n<td>Prompts<\/td>\n<td>User \u2014 template yang dipilih manual<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Transportnya ada dua. <strong>stdio<\/strong> buat server lokal: client menjalankan servermu sebagai subprocess, dan mereka ngobrol lewat stdin\/stdout. Ini yang dipakai tutorial ini. <strong>Streamable HTTP<\/strong> buat server remote, dibahas singkat di akhir. Satu hal yang wajib kamu pegang: revisi spesifikasi <strong>2026-07-28<\/strong> mengubah inti protokol jadi stateless \u2014 handshake <code>initialize<\/code> dan header session <code>Mcp-Session-Id<\/code> dihapus. Kalau tutorial yang kamu ikuti masih menulis <code>server.connect()<\/code> atau <code>server.tool()<\/code>, itu tutorial era 2025.<\/p>\n<h2>Pilih SDK dulu: TypeScript atau Python?<\/h2>\n<p>Dua-duanya SDK resmi, dua-duanya mengimplementasikan revisi 2026-07-28. Pilih berdasarkan bahasa yang sudah kamu pakai sehari-hari.<\/p>\n<table>\n<tbody>\n<tr>\n<th><strong>Perbandingan<\/strong><\/th>\n<th><strong>TypeScript<\/strong><\/th>\n<th><strong>Python<\/strong><\/th>\n<\/tr>\n<tr>\n<td>Paket yang di-install<\/td>\n<td><code>@modelcontextprotocol\/server<\/code> + <code>zod<\/code><\/td>\n<td><code>mcp[cli]<\/code><\/td>\n<\/tr>\n<tr>\n<td>Kelas server<\/td>\n<td><code>McpServer<\/code><\/td>\n<td><code>MCPServer<\/code><\/td>\n<\/tr>\n<tr>\n<td>Cara mendaftarkan tool<\/td>\n<td><code>server.registerTool(nama, config, handler)<\/code><\/td>\n<td>Dekorator <code>@mcp.tool()<\/code> di atas function biasa<\/td>\n<\/tr>\n<tr>\n<td>Skema input<\/td>\n<td>Zod (<code>z.object<\/code>)<\/td>\n<td>Type hints function<\/td>\n<\/tr>\n<tr>\n<td>Menjalankan server<\/td>\n<td><code>serveStdio(factory)<\/code> atau <code>npx tsx<\/code><\/td>\n<td><code>mcp.run()<\/code> atau <code>mcp dev server.py<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Artikel ini memakai TypeScript sebagai jalur utama, karena sebagian besar pembaca yang sudah memakai Claude Code dan OpenClaw sudah punya Node ter-install. Jalur Python dibahas setelahnya. Yang penting: jangan campur tutorial v1 dan v2 \u2014 paket TypeScript lama (<code>@modelcontextprotocol\/sdk<\/code>) itu jalur maintenance, dan kelas <code>FastMCP<\/code> dari Python lama sudah berganti nama jadi <code>MCPServer<\/code> di v2.<\/p>\n<h2>Setup proyek: lima menit, tanpa kejutan<\/h2>\n<p>Cek versi Node dengan <code>node --version<\/code> \u2014 butuh 20 atau lebih baru. Tutorial ini diuji dengan Node 24.<\/p>\n<pre><code>mkdir catatan-mcp &amp;&amp; cd catatan-mcp\r\nnpm init -y\r\nnpm pkg set type=module\r\nnpm install @modelcontextprotocol\/server zod\r\nnpm install -D typescript @types\/node\r\nmkdir src<\/code><\/pre>\n<p>Perhatikan <code>npm pkg set type=module<\/code>: SDK v2 hanya tersedia sebagai ES module. Versi yang ter-install waktu tutorial ini diuji (19 November 2026): <code>@modelcontextprotocol\/server<\/code> 2.4.0, <code>zod<\/code> 4.6.7, <code>typescript<\/code> 5.9.3. Pola kodenya tetap sama selama masih di lini v2.<\/p>\n<p>Buat file <code>tsconfig.json<\/code> di root proyek dan tambahkan script build di <code>package.json<\/code> (<code>\"scripts\": { \"build\": \"tsc\" }<\/code>). Client menjalankan hasil build di <code>build\/index.js<\/code>.<\/p>\n<pre><code>{\r\n  \"compilerOptions\": {\r\n    \"target\": \"ES2022\",\r\n    \"module\": \"Node16\",\r\n    \"moduleResolution\": \"Node16\",\r\n    \"types\": [\"node\"],\r\n    \"outDir\": \".\/build\",\r\n    \"rootDir\": \".\/src\",\r\n    \"strict\": true,\r\n    \"esModuleInterop\": true,\r\n    \"skipLibCheck\": true,\r\n    \"forceConsistentCasingInFileNames\": true\r\n  },\r\n  \"include\": [\"src\/<em><\/em>\/*\"],\r\n  \"exclude\": [\"node_modules\"]\r\n}<\/code><\/pre>\n<h2>Tulis server pertamamu: server catatan<\/h2>\n<p>Ini seluruh servernya, satu file <code>src\/index.ts<\/code>:<\/p>\n<pre><code>#!\/usr\/bin\/env node\r\nimport { McpServer } from \"@modelcontextprotocol\/server\";\r\nimport { serveStdio } from \"@modelcontextprotocol\/server\/stdio\";\r\nimport * as z from \"zod\/v4\";\r\nimport { mkdir, readFile, readdir, writeFile } from \"node:fs\/promises\";\r\nimport { join } from \"node:path\";\r\n\r\n\/\/ Folder catatan; isi lewat env CATATAN_FOLDER.\r\nconst FOLDER = process.env.CATATAN_FOLDER ?? join(process.cwd(), \"catatan\");\r\n\r\nexport function createServer(): McpServer {\r\n  const server = new McpServer({ name: \"catatan\", version: \"1.0.0\" });\r\n\r\n  \/\/ Tool 1: simpan satu catatan sebagai file Markdown.\r\n  server.registerTool(\r\n    \"simpan-catatan\",\r\n    {\r\n      description:\r\n        \"Simpan satu catatan teks ke folder catatan. Pakai saat user minta mengingat atau mencatat sesuatu.\",\r\n      inputSchema: z.object({\r\n        judul: z\r\n          .string()\r\n          .min(1)\r\n          .max(100)\r\n          .describe(\"Judul catatan, dipakai sebagai nama file tanpa spasi\"),\r\n        isi: z.string().min(1).describe(\"Isi catatan, teks biasa atau Markdown\"),\r\n      }),\r\n    },\r\n    async ({ judul, isi }) =&gt; {\r\n      const aman = judul.replace(\/[^a-zA-Z0-9-_]\/g, \"-\");\r\n      await mkdir(FOLDER, { recursive: true });\r\n      await writeFile(join(FOLDER, <code>${aman}.md<\/code>), isi, \"utf-8\");\r\n      return {\r\n        content: [{ type: \"text\", text: <code>Catatan tersimpan: ${aman}.md<\/code> }],\r\n      };\r\n    },\r\n  );\r\n\r\n  \/\/ Tool 2: cari catatan yang mengandung kata kunci.\r\n  server.registerTool(\r\n    \"cari-catatan\",\r\n    {\r\n      description:\r\n        \"Cari catatan yang mengandung kata kunci tertentu. Kembalikan nama file yang cocok.\",\r\n      inputSchema: z.object({\r\n        kataKunci: z\r\n          .string()\r\n          .min(1)\r\n          .describe(\"Kata kunci yang dicari di isi catatan\"),\r\n      }),\r\n    },\r\n    async ({ kataKunci }) =&gt; {\r\n      await mkdir(FOLDER, { recursive: true });\r\n      const files = (await readdir(FOLDER)).filter((f) =&gt; f.endsWith(\".md\"));\r\n      const cocok: string[] = [];\r\n      for (const f of files) {\r\n        const isi = await readFile(join(FOLDER, f), \"utf-8\");\r\n        if (isi.toLowerCase().includes(kataKunci.toLowerCase())) cocok.push(f);\r\n      }\r\n      return {\r\n        content: [\r\n          {\r\n            type: \"text\",\r\n            text: cocok.length\r\n              ? <code>Ditemukan di: ${cocok.join(\", \")}<\/code>\r\n              : \"Tidak ada catatan yang cocok.\",\r\n          },\r\n        ],\r\n      };\r\n    },\r\n  );\r\n\r\n  \/\/ Resource: daftar semua catatan yang tersimpan.\r\n  server.registerResource(\r\n    \"daftar-catatan\",\r\n    \"catatan:\/\/daftar\",\r\n    {\r\n      title: \"Daftar catatan\",\r\n      description: \"Daftar semua judul catatan yang tersimpan\",\r\n      mimeType: \"text\/plain\",\r\n    },\r\n    async (uri) =&gt; {\r\n      await mkdir(FOLDER, { recursive: true });\r\n      const files = (await readdir(FOLDER)).filter((f) =&gt; f.endsWith(\".md\"));\r\n      return {\r\n        contents: [\r\n          {\r\n            uri: uri.href,\r\n            text: files.join(\"n\") || \"Belum ada catatan.\",\r\n          },\r\n        ],\r\n      };\r\n    },\r\n  );\r\n\r\n  \/\/ Prompt: template rekap catatan.\r\n  server.registerPrompt(\r\n    \"rekap-catatan\",\r\n    {\r\n      title: \"Rekap catatan\",\r\n      description: \"Buat rekap semua catatan yang tersimpan\",\r\n      argsSchema: z.object({\r\n        fokus: z\r\n          .string()\r\n          .optional()\r\n          .describe(\"Topik yang mau direkap, kosongkan untuk semua topik\"),\r\n      }),\r\n    },\r\n    ({ fokus }) =&gt; ({\r\n      messages: [\r\n        {\r\n          role: \"user\" as const,\r\n          content: {\r\n            type: \"text\" as const,\r\n            text: fokus\r\n              ? <code>Baca semua catatan di folder catatan, lalu buat rekap singkat khusus topik: ${fokus}.<\/code>\r\n              : \"Baca semua catatan di folder catatan, lalu buat rekap singkat per topik.\",\r\n          },\r\n        },\r\n      ],\r\n    }),\r\n  );\r\n\r\n  return server;\r\n}\r\n\r\nvoid serveStdio(createServer);\r\nconsole.error(\"Server catatan MCP jalan di stdio\");<\/code><\/pre>\n<p>Build dan jalankan sekali buat memastikan tidak ada error ketik:<\/p>\n<pre><code>npm run build\r\nnode build\/index.js<\/code><\/pre>\n<p>Kalau tidak ada error, terminal akan diam setelah menampilkan <code>Server catatan MCP jalan di stdio<\/code> \u2014 itu normal: server stdio menunggu client memulai percakapan. Berhentikan dengan <code>Ctrl+C<\/code>.<\/p>\n<p>Tiga hal penting dari kode di atas. <strong>Pertama, <code>registerTool<\/code> menerima tiga hal: nama, konfigurasi, dan handler.<\/strong> Dari skema Zod di <code>inputSchema<\/code>, SDK menurunkan JSON Schema yang dilihat model dan memvalidasi argumen sebelum handler berjalan. Kalau model memanggil <code>simpan-catatan<\/code> tanpa field <code>isi<\/code>, SDK yang menolak.<\/p>\n<p><strong>Kedua, deskripsi itu instruksi, bukan dokumentasi.<\/strong> Model memutuskan kapan memanggil tool dari <code>description<\/code> dan teks <code>.describe()<\/code> di tiap field. Tulis seperti instruksi ke rekan kerja: apa yang dilakukan tool ini, dan kapan dipakai. Deskripsi yang kabur membuat model ragu.<\/p>\n<p><strong>Ketiga, jangan pernah menulis ke stdout di server stdio.<\/strong> Stdout adalah jalur protokolnya \u2014 satu <code>console.log<\/code> nyasar saja sudah cukup merusak aliran pesannya. Itu sebabnya banner di baris terakhir memakai <code>console.error<\/code> (stderr). Aturan yang sama berlaku buat library yang kamu pakai.<\/p>\n<p>Satu detail terakhir: <code>createServer<\/code> ditulis sebagai factory, karena <code>serveStdio<\/code> bisa membangun instance baru tiap ada koneksi. State yang harus bertahan antar-koneksi \u2014 di sini folder catatan di disk \u2014 ditaruh di luar factory, di level modul.<\/p>\n<h2>Versi Python-nya: server yang sama, setengah baris kode<\/h2>\n<p>Kalau kamu tim Python (3.10+, diuji dengan 3.12), server yang sama bisa ditulis lebih pendek, karena SDK Python membaca skema dari type hints function:<\/p>\n<pre><code>mkdir catatan-mcp-py &amp;&amp; cd catatan-mcp-py\r\npython3 -m venv .venv\r\nsource .venv\/bin\/activate\r\npip install \"mcp[cli]\"<\/code><\/pre>\n<p>Paket <code>mcp<\/code> versi 2.3.0 adalah yang ter-install waktu tutorial ini diuji (19 November 2026). Ini file <code>server.py<\/code> lengkapnya:<\/p>\n<pre><code>\"\"\"Server catatan MCP - Python SDK v2 (MCPServer).\"\"\"\r\nimport os\r\nimport re\r\nfrom pathlib import Path\r\n\r\nfrom mcp.server import MCPServer\r\n\r\nFOLDER = Path(os.environ.get(\"CATATAN_FOLDER\", Path.cwd() \/ \"catatan\"))\r\nFOLDER.mkdir(parents=True, exist_ok=True)\r\n\r\nmcp = MCPServer(\"catatan\")\r\n\r\n\r\ndef _aman(judul: str) -&gt; str:\r\n    return re.sub(r\"[^a-zA-Z0-9-_]\", \"-\", judul)\r\n\r\n\r\n@mcp.tool()\r\ndef simpan_catatan(judul: str, isi: str) -&gt; str:\r\n    \"\"\"Simpan satu catatan teks ke folder catatan sebagai file Markdown.\"\"\"\r\n    nama = _aman(judul) + \".md\"\r\n    (FOLDER \/ nama).write_text(isi, encoding=\"utf-8\")\r\n    return f\"Catatan tersimpan: {nama}\"\r\n\r\n\r\n@mcp.tool()\r\ndef cari_catatan(kata_kunci: str) -&gt; str:\r\n    \"\"\"Cari catatan yang mengandung kata kunci tertentu.\"\"\"\r\n    cocok = []\r\n    for f in sorted(FOLDER.glob(\"*.md\")):\r\n        if kata_kunci.lower() in f.read_text(encoding=\"utf-8\").lower():\r\n            cocok.append(f.name)\r\n    return f\"Ditemukan di: {', '.join(cocok)}\" if cocok else \"Tidak ada catatan yang cocok.\"\r\n\r\n\r\n@mcp.resource(\"catatan:\/\/daftar\")\r\ndef daftar_catatan() -&gt; str:\r\n    \"\"\"Daftar semua judul catatan yang tersimpan.\"\"\"\r\n    return \"n\".join(sorted(f.name for f in FOLDER.glob(\"*.md\"))) or \"Belum ada catatan.\"\r\n\r\n\r\n@mcp.prompt()\r\ndef rekap_catatan() -&gt; str:\r\n    \"\"\"Buat rekap semua catatan yang tersimpan.\"\"\"\r\n    return \"Baca semua catatan di folder catatan, lalu buat rekap singkat per topik.\"\r\n\r\n\r\nif __name__ == \"__main__\":\r\n    mcp.run()<\/code><\/pre>\n<p>Tiga hal yang perlu diperhatikan. <strong>Pertama, import-nya <code>from mcp.server import MCPServer<\/code>.<\/strong> Bukan <code>from mcp import MCPServer<\/code> \u2014 bentuk itu tidak ada \u2014 dan bukan <code>from mcp.server.fastmcp import FastMCP<\/code>.<\/p>\n<p><strong>Kedua, satu dekorator per primitif.<\/strong> <code>@mcp.tool()<\/code> membuat function jadi tool, <code>@mcp.resource(\"catatan:\/\/daftar\")<\/code> jadi resource, <code>@mcp.prompt()<\/code> jadi prompt. Nama, deskripsi, dan skema dibaca SDK dari nama function, docstring, dan type hints-nya.<\/p>\n<p><strong>Ketiga, <code>mcp.run()<\/code> tanpa argumen menjalankan server lewat stdio.<\/strong> Buat HTTP: <code>mcp run server.py --transport streamable-http<\/code>. Satu perbedaan kecil: nama tool Python memakai garis bawah (<code>simpan_catatan<\/code>), bukan tanda hubung (<code>simpan-catatan<\/code>).<\/p>\n<h2>Uji dulu dengan MCP Inspector, sebelum AI yang mencoba<\/h2>\n<p>MCP Inspector adalah client uji resmi: aplikasi web lokal yang memanggil tool servermu langsung, tanpa model AI di tengah. Inspector butuh Node 22.19 atau lebih baru. Jalankan dari root proyek TypeScript:<\/p>\n<pre><code>npx @modelcontextprotocol\/inspector npx tsx src\/index.ts<\/code><\/pre>\n<p>Perintah itu membuka tab browser. Klik <strong>Connect<\/strong>, lalu buka tab <strong>Tools<\/strong>: kamu akan melihat <code>simpan-catatan<\/code> dan <code>cari-catatan<\/code> dengan form input yang dibuat otomatis dari skema Zod-mu. Isi judul dan isi, jalankan, dan periksa apakah file <code>.md<\/code>-nya muncul. Lalu cek tab <strong>Resources<\/strong> dan <strong>Prompts<\/strong>. Buat server Python: <code>mcp dev server.py<\/code>.<\/p>\n<p>Aturan mainnya: kalau Inspector tidak bisa melihat tool-mu, Claude juga tidak akan bisa. Jangan lanjut sebelum Inspector menunjukkan kedua tool, satu resource, dan satu prompt dengan benar.<\/p>\n<h2>Sambungkan ke Claude Code<\/h2>\n<p>Server sudah jalan dan sudah lolos Inspector. Sambungkan ke Claude Code dengan satu perintah dari terminal \u2014 bukan dari dalam sesi Claude Code:<\/p>\n<pre><code>claude mcp add --transport stdio catatan -- node \/ABSOLUTE\/PATH\/catatan-mcp\/build\/index.js<\/code><\/pre>\n<p>Tanda <code>--<\/code> memisahkan opsi milik Claude dari perintah yang menjalankan servermu, dan path-nya harus absolut \u2014 client bisa menjalankan server dari direktori mana pun. Kalau folder catatanmu bukan di lokasi default, tambahkan environment variable-nya dengan flag <code>-e<\/code>:<\/p>\n<pre><code>claude mcp add --transport stdio catatan -e CATATAN_FOLDER=\/home\/kamu\/dokumen\/catatan -- node \/ABSOLUTE\/PATH\/catatan-mcp\/build\/index.js<\/code><\/pre>\n<p>Perintah itu menyimpan server di scope <strong>local<\/strong> (default). Ada dua scope lain:<\/p>\n<table>\n<tbody>\n<tr>\n<th><strong>Scope<\/strong><\/th>\n<th><strong>Flag<\/strong><\/th>\n<th><strong>Siapa yang dapat<\/strong><\/th>\n<\/tr>\n<tr>\n<td>Local (default)<\/td>\n<td>(tanpa flag)<\/td>\n<td>Kamu, proyek ini saja<\/td>\n<\/tr>\n<tr>\n<td>Project<\/td>\n<td><code>--scope project<\/code><\/td>\n<td>Seluruh tim, ikut version control<\/td>\n<\/tr>\n<tr>\n<td>User<\/td>\n<td><code>--scope user<\/code><\/td>\n<td>Kamu, di semua proyekmu<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Buat server yang dipakai satu tim, pakai scope project \u2014 file <code>.mcp.json<\/code>-nya bisa di-commit:<\/p>\n<pre><code>{\r\n  \"mcpServers\": {\r\n    \"catatan\": {\r\n      \"type\": \"stdio\",\r\n      \"command\": \"node\",\r\n      \"args\": [\"\/ABSOLUTE\/PATH\/catatan-mcp\/build\/index.js\"],\r\n      \"env\": {\r\n        \"CATATAN_FOLDER\": \"\/home\/kamu\/dokumen\/catatan\"\r\n      }\r\n    }\r\n  }\r\n}<\/code><\/pre>\n<p>Dua catatan soal file ini. <strong>Pertama, jangan pernah menulis token atau kredensial asli di dalamnya<\/strong> \u2014 file ini masuk version control, jadi pakai ekspansi environment variable buat nilai rahasia. <strong>Kedua, Claude Code meminta persetujuan dulu sebelum memakai server dari <code>.mcp.json<\/code> di sesi interaktif<\/strong>, tapi di mode non-interaktif \u2014 misalnya <code>claude -p<\/code> \u2014 server dimuat tanpa bertanya.<\/p>\n<p>Verifikasi dengan <code>claude mcp list<\/code> \u2014 server <code>catatan<\/code> harus berstatus Connected \u2014 atau ketik <code>\/mcp<\/code> di dalam sesi. Lalu coba: &#8220;Simpan catatan: rapat Kamis pindah ke jam 10.&#8221; Claude seharusnya memanggil <code>simpan-catatan<\/code>, dan file-nya muncul di folder catatanmu. Satu hal yang akan kamu temukan: semua sub-agent ikut mewarisi tool-nya, termasuk tool yang bisa menulis file. Itu default yang disengaja, tapi buat server yang menyentuh sistem penting, kamu pasti mau menguncinya. <a href=\"https:\/\/komunitech.com\/blog\/tutorial\/claude-code-subagents-mcp-cara-batasi-akses-tool-per-sub-agent-2026\/\">Cara membatasi akses tool MCP per sub-agent<\/a> dibahas terpisah \u2014 nama lengkap tool-nya di sini adalah <code>mcp__catatan__simpan-catatan<\/code> dan <code>mcp__catatan__cari-catatan<\/code>.<\/p>\n<h2>Sambungkan ke OpenClaw<\/h2>\n<p>Server yang sama bisa dipakai OpenClaw tanpa mengubah satu baris kode pun. Cara paling aman menambahkannya adalah lewat Control UI (<strong>Settings \u2192 MCP \u2192 Add server<\/strong>) atau lewat CLI:<\/p>\n<pre><code>openclaw mcp add catatan -- node \/ABSOLUTE\/PATH\/catatan-mcp\/build\/index.js\r\nopenclaw mcp list\r\nopenclaw mcp doctor catatan --probe<\/code><\/pre>\n<p>Perintah <code>doctor --probe<\/code> itu penting: menyimpan definisi server tidak membuktikan apa-apa soal keterjangkauannya \u2014 probe itu yang membuktikan. Kalau <code>openclaw mcp list<\/code> menunjukkan servermu berjalan, agent-mu sudah bisa memanggil tool-nya. Buat server Python, ganti command-nya dengan path absolut ke interpreter di dalam virtual environment \u2014 <code>python<\/code> di PATH OpenClaw belum tentu Python yang sudah ter-install paket <code>mcp<\/code>.<\/p>\n<p>Kalau kamu lebih suka mengedit <code>~\/.openclaw\/openclaw.json<\/code> manual, satu hal yang perlu kamu tahu: nama kunci konfigurasinya pernah berubah antar versi \u2014 dokumentasi komunitas terbaru menuliskannya sebagai <code>mcp.servers<\/code>, sementara panduan yang lebih lama menuliskannya sebagai <code>mcpServers<\/code>. Karena itu, cara yang paling tidak berisiko adalah memakai CLI atau Control UI di atas.<\/p>\n<h2>Kalau mentok: error yang paling sering<\/h2>\n<p>Sebagian besar kegagalan MCP server pertama berasal dari segelintir penyebab yang sama:<\/p>\n<table>\n<tbody>\n<tr>\n<th><strong>Gejala<\/strong><\/th>\n<th><strong>Kemungkinan penyebab<\/strong><\/th>\n<th><strong>Perbaikannya<\/strong><\/th>\n<\/tr>\n<tr>\n<td>Client bilang server tidak ditemukan \/ gagal start<\/td>\n<td>Path relatif, atau file build belum ada<\/td>\n<td>Pakai path absolut ke <code>build\/index.js<\/code>, dan jalankan <code>npm run build<\/code> dulu<\/td>\n<\/tr>\n<tr>\n<td>Server terputus acak, error JSON tidak valid<\/td>\n<td><code>console.log<\/code> atau log library ke stdout<\/td>\n<td>Semua log harus ke <code>console.error<\/code> (stderr)<\/td>\n<\/tr>\n<tr>\n<td><code>server.tool is not a function<\/code> \/ import FastMCP gagal<\/td>\n<td>Kode tutorial v1 dipakai di SDK v2 (atau sebaliknya)<\/td>\n<td>TS: <code>registerTool<\/code> dan paket <code>@modelcontextprotocol\/server<\/code>. Python: <code>MCPServer<\/code> dari <code>mcp.server<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Satu prinsip debugging yang menghemat waktu: uji berlapis. Pertama Inspector \u2014 kalau di sana jalan, servermu benar. Kedua <code>claude mcp list<\/code> atau <code>openclaw mcp list<\/code> \u2014 kalau di sana Connected, konfigurasinya benar.<\/p>\n<h2>Seberapa jauh server ini bisa dibawa?<\/h2>\n<p>Server catatan ini sengaja kecil, tapi polanya sudah lengkap. Buat membawanya lebih jauh: <strong>pertama, ganti sumber datanya<\/strong> \u2014 tool yang sekarang membaca folder bisa membaca database atau API internal. <strong>Kedua, tambah tool dengan hati-hati<\/strong> \u2014 tiap tool baru menambah pilihan yang harus dipertimbangkan model.<\/p>\n<p><strong>Ketiga, naik ke HTTP kalau servernya perlu dipakai banyak orang.<\/strong> Factory <code>createServer<\/code> yang sama dipakai ulang lewat handler HTTP \u2014 di SDK TypeScript, <code>createMcpHandler<\/code> membangun server baru per request. Endpoint-nya jadi <code>http:\/\/127.0.0.1:3000\/mcp<\/code>, dan client menyambung dengan <code>claude mcp add --transport http catatan http:\/\/127.0.0.1:3000\/mcp<\/code>. Tapi ingat: handler itu tidak memeriksa Host, Origin, atau autentikasi sendiri \u2014 jangan pernah mengekspos server HTTP tanpa autentikasi ke internet.<\/p>\n<p>Terakhir, soal keamanan: server MCP yang membaca folder atau database adalah jalur baru ke sistemmu. Batasi foldernya sesempit mungkin, dan jangan pernah menyambungkan server yang tidak kamu kenal asal-usulnya. Soal posisi MCP di gambaran yang lebih besar: MCP itu lapisan eksekusi, cara satu agent mengakses kemampuan. Kalau kamu membangun sistem di mana beberapa agent harus bekerja sama, di situlah <a href=\"https:\/\/komunitech.com\/blog\/ai-agent\/a2a-vs-mcp-standar-komunikasi-antar-ai-agent\/\">perbandingan A2A dan MCP<\/a> jadi relevan: A2A buat koordinasi antar-agent, MCP buat eksekusi ke tools dan data.<\/p>\n<h2>Pertanyaan yang sering ditanya soal ini<\/h2>\n<h3>Apakah saya harus bisa coding buat bikin MCP server?<\/h3>\n<p>Ya, tapi tidak banyak: server di tutorial ini sekitar 100 baris TypeScript atau 40 baris Python. Kalau kamu cuma mau memakai server MCP yang sudah ada, kamu tidak perlu coding.<\/p>\n<h3>TypeScript atau Python, mana yang sebaiknya saya pilih?<\/h3>\n<p>Pilih bahasa yang sudah kamu pakai sehari-hari. Kalau kamu sudah pakai Node atau Claude Code, TypeScript jalurnya paling pendek; kalau servermu membungkus script Python yang sudah ada, Python lebih cepat selesai.<\/p>\n<h3>Kenapa tutorial lama yang saya ikuti tidak jalan?<\/h3>\n<p>Hampir pasti karena perbedaan versi SDK. Di TypeScript, <code>server.tool()<\/code> sudah digantikan <code>registerTool<\/code>; di Python, <code>FastMCP<\/code> sudah berganti nama jadi <code>MCPServer<\/code>. Cocokkan dulu versi SDK-nya sebelum menyalahkan kodemu.<\/p>\n<h3>Apakah server saya bisa dipakai client selain Claude Code dan OpenClaw?<\/h3>\n<p>Bisa, selama client itu mengikuti spesifikasi MCP yang sama. Server yang kamu bangun sekali bisa dipakai Claude Desktop, VS Code, dan Cursor tanpa perubahan \u2014 yang beda cuma format file konfigurasinya.<\/p>\n<h3>Apakah aman memberi AI akses tulis ke folder saya?<\/h3>\n<p>Aman kalau batasnya kamu yang tentukan. Server contoh ini cuma bisa menulis file <code>.md<\/code> di satu folder khusus, dan nama file dibersihkan dari karakter berbahaya.<\/p>\n<h3>Apa bedanya MCP server dengan API biasa?<\/h3>\n<p>API biasa butuh kode integrasi custom buat tiap pasangan aplikasi dan sistem. MCP menstandarkan cara aplikasi AI menemukan dan memanggil kemampuan secara otomatis, sehingga model sendiri yang menyusun urutan pemakaiannya.<\/p>\n<h2>Penutup: satu server kecil, satu kemampuan yang nempel terus<\/h2>\n<p>Yang kamu bangun hari ini cuma server catatan \u2014 dua tool, satu resource, satu prompt. Tapi pola di dalamnya adalah pola yang sama dipakai server MCP produksi: daftarkan kemampuan dengan deskripsi yang jelas, validasi argumen sebelum handler berjalan, uji di Inspector, dan batasi aksesnya sesempit mungkin.<\/p>\n<p>Mulai dari yang kecil dan yang kamu pakai setiap hari: server yang membaca folder kerjamu atau mencatat hasil risetmu. Itulah server yang akan kamu rawat, dan dari sanalah kamu belajar bagian mana dari MCP yang benar-benar penting. Standarnya boleh berubah tiap tahun, tapi kemampuan membangun jembatan antara AI dan datamu sendiri itu yang nempel terus.<\/p>\n<p>Kamu sendiri gimana? Sudah coba membangun MCP server sendiri, atau masih mentok di salah satu langkah di atas? Ceritain di kolom komentar \u2014 aku pengin tahu server pertama apa yang kamu bangun.<\/p>\n<h2>Sumber dan bacaan lanjutan<\/h2>\n<ul>\n<li>Spesifikasi resmi Model Context Protocol, revisi 2026-07-28: <em><a href=\"https:\/\/modelcontextprotocol.io\/specification\/2026-07-28\" target=\"_blank\" rel=\"noopener\">https:\/\/modelcontextprotocol.io\/specification\/2026-07-28<\/a><\/em><\/li>\n<li>Dokumentasi MCP TypeScript SDK v2 \u2014 quickstart &#8220;Build your first server&#8221;: <em><a href=\"https:\/\/ts.sdk.modelcontextprotocol.io\/v2\/llms-full.txt\" target=\"_blank\" rel=\"noopener\">https:\/\/ts.sdk.modelcontextprotocol.io\/v2\/llms-full.txt<\/a><\/em><\/li>\n<li>Dokumentasi MCP Python SDK v2 \u2014 First steps: <em><a href=\"https:\/\/github.com\/modelcontextprotocol\/python-sdk\/blob\/main\/docs\/get-started\/first-steps.md\" target=\"_blank\" rel=\"noopener\">https:\/\/github.com\/modelcontextprotocol\/python-sdk\/blob\/main\/docs\/get-started\/first-steps.md<\/a><\/em><\/li>\n<li>Build an MCP Server in TypeScript, SDK v2 Tutorial (24 Oktober 2026): <em><a href=\"https:\/\/www.claudekit.ai\/guides\/build-mcp-server-typescript\/\" target=\"_blank\" rel=\"noopener\">https:\/\/www.claudekit.ai\/guides\/build-mcp-server-typescript\/<\/a><\/em><\/li>\n<li>Dokumentasi Claude Code \u2014 MCP: <em><a href=\"https:\/\/code.claude.com\/docs\/mcp\" target=\"_blank\" rel=\"noopener\">https:\/\/code.claude.com\/docs\/mcp<\/a><\/em><\/li>\n<li>MCP Servers \u2014 OpenClaw Docs (dokumentasi komunitas): <em><a href=\"https:\/\/clawdocs.org\/guides\/mcp-servers\" target=\"_blank\" rel=\"noopener\">https:\/\/clawdocs.org\/guides\/mcp-servers<\/a><\/em><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>MCP server adalah program kecil yang memberi AI akses ke data dan aksimu lewat protokol standar \u2014 dan membangunnya sendiri ternyata tidak sesulit yang dibayangkan. Tutorial ini membawamu dari nol sampai server catatan yang jalan, ditulis dengan MCP SDK v2 (TypeScript dan Python) dan diuji 19 November 2026, lalu disambungkan ke Claude Code dan OpenClaw.<\/p>\n","protected":false},"author":1,"featured_media":3177,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[75],"tags":[],"class_list":["post-3173","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorial"],"acf":[],"_links":{"self":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/3173","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/comments?post=3173"}],"version-history":[{"count":3,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/3173\/revisions"}],"predecessor-version":[{"id":3179,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/posts\/3173\/revisions\/3179"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/media\/3177"}],"wp:attachment":[{"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/media?parent=3173"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/categories?post=3173"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/komunitech.com\/blog\/wp-json\/wp\/v2\/tags?post=3173"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}