تکداک را به Claude و هر ابزار هوش مصنوعی وصل کنید
Model Context Protocol
اتصال به دستیارهای هوش مصنوعی
- ۱در فضای کاری به تنظیمات ← توسعهدهندگان بروید و یک کلید API بسازید.
- ۲نمونه پیکربندی ابزارتان را کپی کنید؛ کلید شما خودکار در آن گذاشته شده است.
- ۳از دستیار بخواهید کاری انجام دهد؛ همه تغییرها به نام شما و با دسترسی شما ثبت میشود.
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اعضای فضای کاری برای سپردن کارچه بخواهید؟
کارهای بورد پروژه که موعدشان گذشته را پیدا کن و برای هر کدام یک نظر یادآوری بگذار.
از صفحه «جلسه هفتگی» کارهای تصمیمگرفتهشده را دربیاور و در بورد پروژه به اسم مسئولش بساز.
این مقاله را بخوان و خلاصهاش را بهصورت یک صفحه تازه زیر «دانشنامه» بنویس.
وضعیت همه کارهای برچسب «فوری» را گزارش کن و بگو کدامها مسئول ندارند.
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_…")کار تیمتان را امروز در تکداک مرتب کنید
ثبتنام با شماره موبایل، کمتر از یک دقیقه. پلن رایگان محدودیت زمانی ندارد.
ساخت فضای کاری رایگان