مفهوم عملیاتی از طریق کلود دسکتاپ با استفاده از MCP!

Summarize this content to 400 words in Persian Lang

مقدمه

اخیراً، MCP توسط Anthropic اعلام شده است، و ممکن است از خود بپرسید که دقیقاً چه کاری می تواند انجام دهد؟ در این مقاله، یک مثال کاربردی از استفاده از MCP برای کارکردن Notion به طور مستقیم از Claude Desktop را بررسی خواهیم کرد.

پس زمینه

من قبلاً یک درخواست کششی برای پیاده‌سازی یک سرور مفهومی در پروژه سرور MCP ارسال کرده بودم و قصد داشتم یک راهنمای دقیق را پس از ادغام آن بنویسم. با این حال، به نظر می رسد MCP به جای مدیریت مرکزی همه سرورها، به سمت یک مدل میزبانی غیرمتمرکز برای مقیاس پذیری حرکت می کند. از آنجایی که روابط عمومی من ممکن است بسته باشد، تصمیم گرفتم این راهنما را بنویسم تا مطمئن شوم که دیگران همچنان می توانند از آن استفاده کنند. (بحث را اینجا ببینید)

درخواست کشش در اینجا:https://github.com/modelcontextprotocol/servers/pull/129

آماده سازی

راه اندازی MCP Notion Server

من یک مخزن ایجاد کرده ام تا کار را برای شما آسان تر کنم. از لینک زیر آن را کلون کنید:

git clone https://github.com/suekou/mcp-notion-server.git

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

سپس دستورات زیر را اجرا کنید:

cd notion
npm run build
npm link

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

پس از اجرا از فایل مطمئن شوید notion/build/index.js با موفقیت ایجاد شده است.

در حال آماده کردن Notion API Token

برای اجازه دادن به سرور MCP برای دسترسی به Notion، یک توکن API ایجاد کنید. به صفحه Integrations رفته و انتخاب کنید ادغام جدید.نام ادغام را پر کنید، یک فضای کاری انتخاب کنید و Type as را نگه دارید داخلی (پیش فرض).

پس از ایجاد ادغام، به صفحه جزئیات آن بروید و با کلیک کردن، توکن را کپی کنید نمایش → کپی:

در حال ویرایش claude_desktop_config.json

را ویرایش کنید claude_desktop_config.json فایل واقع در:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

در این فایل مسیر را به notion/build/index.js فایلی که قبلا ساخته اید (به عنوان مثال، /Users//Desktop/mcp-notion-server/notion/build/index.js) زیر argsو کد API را در زیر بچسبانید NOTION_API_TOKEN مانند این:

{
“mcpServers”: {
“notion”: {
“command”: “node”,
“args”: [
“Path to the built file”
],
“env”: {
“NOTION_API_TOKEN”: “Your token”
}
}
}
}

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

اگر سرورهای دیگری را در کنار این پیکربندی می کنید، ممکن است پیکربندی شما به این صورت باشد:

{
“mcpServers”: {
“sqlite”: {
“command”: “uvx”,
“args”: [
“mcp-server-sqlite”,
“–db-path”,
“/Users/USER_NAME/test.db”
] },
“notion”: {
“command”: “node”,
“args”: [
“/Users/USER_NAME/Desktop/mcp-notion-server/notion/build/index.js”
],
“env”: {
“NOTION_API_TOKEN”: “API_TOKEN”
}
}
}
}

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

اتصال ادغام

در فضای کاری که قبلاً پیکربندی کردید، یک صفحه جدید ایجاد کنید. سپس بر روی آن کلیک کنید … را در گوشه سمت راست بالا قرار داده و انتخاب کنید اتصال به، به دنبال آن یکپارچه سازی شما.

سپس شناسه صفحه را از URL کپی کنید. به عنوان مثال، اگر URL این است:

https://www.notion.so/mcp-test-notion1234server567apiintegration890

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

آخرین رشته الفبایی 32 کاراکتری (notion1234server567apiintegration890) شناسه صفحه شماست.

بیایید آن را امتحان کنیم!

یک مقاله را ذخیره کنید

اگر دسکتاپ Claude از قبل باز است، راه اندازی مجدد کنید. پس از راه‌اندازی مجدد، روی نماد چکش کلیک کنید و بررسی کنید که «مفهوم» در زیر ظاهر می‌شود یا خیر از سرور. اگر این کار را کرد، شما آماده رفتن هستید.

حالا بیایید از کلود بخواهیم مقاله ای بنویسد.

پس از اتمام، پیام را ارسال کنید:«من می‌خواهم این محتوا را در Notion ذخیره کنم ”

کلود از شما می خواهد مجوزهای استفاده از ابزار را دریافت کنید – آن را تأیید کنید.

پس از اجرا، باید مقاله ذخیره شده در صفحه مفهوم خود را مشاهده کنید:

استفاده از پایگاه های داده

یک پایگاه داده در Notion ایجاد کنید. در اینجا مثالی وجود دارد که من از کلود خواستم یک پایگاه داده فیلم ایجاد کند:

چند ورودی نمونه اضافه کنید:

حالا از کلود بپرسید:”فیلم های دارای رتبه ⭐️⭐️⭐️⭐️⭐️ را به من بگو.”

فقط فیلم های 5 ستاره را بازیابی و فهرست می کند:

نتیجه گیری

این مقاله تنها چند ویژگی MCP Notion Server را معرفی می‌کند، اما کارهای بسیار بیشتری وجود دارد که می‌توانید با آن انجام دهید. با آن آزمایش کنید و پتانسیل آن را کشف کنید!اگر سرور را سفارشی کرده اید یا موارد استفاده جدیدی را کشف کرده اید، مایلم در مورد یافته های شما بشنوم! با تشکر از شما برای خواندن! 👋

git clone https://github.com/suekou/mcp-notion-server.git

cd notion
npm run build
npm link

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "Path to the built file"
      ],
      "env": {
        "NOTION_API_TOKEN": "Your token"
      }
    }
  }
}

{
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": [
        "mcp-server-sqlite",
        "--db-path",
        "/Users/USER_NAME/test.db"
      ]
    },
    "notion": {
      "command": "node",
      "args": [
        "/Users/USER_NAME/Desktop/mcp-notion-server/notion/build/index.js"
      ],
      "env": {
        "NOTION_API_TOKEN": "API_TOKEN"
      }
    }
  }
}

https://www.notion.so/mcp-test-notion1234server567apiintegration890