توسعه‌دهندگان

تک‌داک را به Claude و هر ابزار هوش مصنوعی وصل کنید

با MCP دستیار هوش مصنوعی‌تان همکار تیم می‌شود: صفحه‌ها را می‌خواند، کار می‌سازد و پیش می‌برد. با REST API و وب‌هوک هم هر سیستم دیگری را وصل کنید.

Model Context Protocol

اتصال به دستیارهای هوش مصنوعی

  1. ۱در فضای کاری به تنظیمات ← توسعه‌دهندگان بروید و یک کلید API بسازید.
  2. ۲نمونه پیکربندی ابزارتان را کپی کنید؛ کلید شما خودکار در آن گذاشته شده است.
  3. ۳از دستیار بخواهید کاری انجام دهد؛ همه تغییرها به نام شما و با دسترسی شما ثبت می‌شود.

Claude (وب، دسکتاپ و موبایل)

در Settings → Connectors گزینه Add custom connector را بزنید و این نشانی را با کلید خودتان بدهید:

https://techdoc.ir/api/mcp/dft_…

Claude Code

در ترمینال:

claude mcp add --transport http techdoc https://techdoc.ir/api/mcp --header "Authorization: Bearer dft_…"

Cursor، VS Code و Windsurf

در ~/.cursor/mcp.json یا فایل تنظیمات MCP ابزارتان:

{
  "mcpServers": {
    "techdoc": {
      "type": "http",
      "url": "https://techdoc.ir/api/mcp",
      "headers": {
        "Authorization": "Bearer dft_…"
      }
    }
  }
}

ChatGPT

در GPT سفارشی، Actions → Import from URL و احراز هویت API Key / Bearer:

https://techdoc.ir/api/v1/openapi.json

نشانی MCP: https://techdoc.ir/api/mcp (Streamable HTTP، با سرآیند Authorization: Bearer). برای ابزارهایی که فقط نشانی می‌گیرند، کلید را بعد از /api/mcp/ بگذارید و آن نشانی را مثل رمز نگه دارید.

ابزارهایی که دستیار در اختیار دارد

searchجستجوی متن کامل در عنوان و محتوای صفحه‌ها و ردیف‌ها
list_pagesفهرست صفحه‌ها و دیتابیس‌ها با ساختار درختی
get_pageخواندن صفحه به‌صورت Markdown، و مقادیر ستون‌ها برای ردیف‌ها
create_pageساخت صفحه با عنوان، فهرست، چک‌لیست و متن
update_pageتغییر عنوان، بازنویسی متن یا افزودن به انتهای صفحه
archive_pageانتقال صفحه یا ردیف به سطل (قابل بازگشت)
get_databaseستون‌ها و ردیف‌های یک دیتابیس با نام گزینه‌ها و افراد
add_rowافزودن کار یا ردیف با مقدارها به زبان ساده: «وضعیت: در حال انجام»
update_rowتغییر وضعیت، مسئول، موعد و هر ستون دیگر
list_commentsخواندن گفتگوهای یک صفحه
add_commentنوشتن نظر یا پاسخ در گفتگو
list_membersاعضای فضای کاری برای سپردن کار

چه بخواهید؟

کارهای بورد پروژه که موعدشان گذشته را پیدا کن و برای هر کدام یک نظر یادآوری بگذار.

از صفحه «جلسه هفتگی» کارهای تصمیم‌گرفته‌شده را دربیاور و در بورد پروژه به اسم مسئولش بساز.

این مقاله را بخوان و خلاصه‌اش را به‌صورت یک صفحه تازه زیر «دانشنامه» بنویس.

وضعیت همه کارهای برچسب «فوری» را گزارش کن و بگو کدام‌ها مسئول ندارند.

REST API

خواندن و نوشتن از هر برنامه‌ای

همه درخواست‌ها به https://techdoc.ir/api/v1 می‌روند و با سرآیند Authorization: Bearer dft_… شناخته می‌شوند. هر کلید با نقش و دسترسی سازنده‌اش کار می‌کند؛ ستون‌ها و گزینه‌ها را می‌توانید با نامشان بفرستید. مشخصات کامل در OpenAPI است و n8n، Make، Postman و GPT‌ها مستقیم آن را می‌خوانند.

GET/search?q=جستجو در صفحه‌ها و ردیف‌ها
GET/pagesفهرست صفحه‌ها و دیتابیس‌ها
POST/pagesساخت صفحه{ title, parentId?, text? }
GET/pages/:idخواندن صفحه یا ردیف
PATCH/pages/:idتغییر صفحه{ title?, text? | appendText? }
DELETE/pages/:idانتقال به سطل
GET/databases/:idستون‌ها و ردیف‌های دیتابیس
POST/databases/:id/rowsافزودن ردیف{ title, properties }
PATCH/rows/:idتغییر ردیف{ title?, properties? }
GET · POST/pages/:id/commentsخواندن و نوشتن نظر{ body, parentId? }
GET/usersاعضای فضای کاری
curl -X POST https://techdoc.ir/api/v1/databases/<id>/rows \
  -H "Authorization: Bearer dft_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "بررسی قرارداد",
    "properties": {
      "وضعیت": "در حال انجام",
      "مسئول": "سارا",
      "due": "2026-11-20"
    }
  }'

ستون‌ها را با نام یا شناسه‌شان بفرستید (اینجا due شناسه ستون موعد است). ساخت یا تغییر ردیف از API هم اتوماسیون‌های دیتابیس و وب‌هوک‌ها را اجرا می‌کند.

Webhooks

با هر تغییر خبردار شوید

مالک و مدیران در تنظیمات ← توسعه‌دهندگان نشانی وب‌هوک و رویدادهایش را انتخاب می‌کنند. هر رویداد با POST و بدنه JSON فرستاده می‌شود و امضای HMAC-SHA256 آن در سرآیند X-TechDoc-Signature است. با دکمه «ارسال آزمایشی» یک رویداد ping بفرستید و اتصال را بسنجید.

row.createdردیف ساخته شدrow.updatedردیف تغییر کردrow.deletedردیف حذف شدpage.createdصفحه ساخته شدpage.updatedصفحه تغییر کردpage.archivedصفحه به سطل رفتcomment.createdنظر تازهmessage.createdپیام تازه در کانال عمومی

نمونه بدنه

{
  "event": "row.updated",
  "workspaceId": "2f45…",
  "at": "2026-11-10T09:30:00.000Z",
  "data": {
    "databaseId": "d9f1…",
    "row": {
      "id": "7935…",
      "title": "نوشتن مستندات",
      "properties": { "status": "done" }
    }
  }
}

بررسی امضا در Node.js

import { createHmac, timingSafeEqual } from "node:crypto";

// body: the raw request body as a string
function verify(body, header, secret) {
  const expected = "sha256=" + createHmac("sha256", secret).update(body).digest("hex");
  return header.length === expected.length && timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}

// verify(rawBody, req.headers["x-techdoc-signature"], "whsec_…")

امنیت

  • کلیدها فقط یک بار نمایش داده می‌شوند و فقط هش آن‌ها ذخیره می‌شود؛ هر وقت لازم شد باطلشان کنید.
  • هر کلید فقط به همان فضای کاری و همان صفحه‌هایی دسترسی دارد که سازنده‌اش دارد. مهمان‌ها کلید نمی‌سازند.
  • حذف از طریق API و MCP فقط به سطل می‌برد و از سطل قابل بازگشت است.

کار تیم‌تان را امروز در تک‌داک مرتب کنید

ثبت‌نام با شماره موبایل، کمتر از یک دقیقه. پلن رایگان محدودیت زمانی ندارد.

ساخت فضای کاری رایگان