مستندات

اتصال‌دهنده‌های هوش مصنوعی

Q: آیا میتوانم متره عملیات خاکی را از ChatGPT یا Claude انجام دهم؟

بله. SitesAI Estimate را بهعنوان کانکتور (با آدرس https://takeoff.sitesai.net/api/mcp) در Claude، Claude Code، Codex یا ChatGPT وصل کنید. بعد یک تب SitesAI Estimate را که در آن وارد حساب خود شدهاید باز بگذارید و درخواستتان را بنویسید. دستیار با ابزارهای فهرستشده در بالا پروژه را باز میکند، نقشه را کالیبره میکند، متره را ترسیم میکند و ردیفها را قیمتگذاری میکند. هر تغییر در تب شما نمایش داده میشود تا پیش از صدور پیشفاکتور آن را بررسی کنید.

Claude، Codex، ChatGPT یا هر دستیار هوش مصنوعی سازگار با MCP را به داده‌های SitesAI خودتان وصل کنید — اینکه اتصال‌دهنده‌ها چه می‌کنند، چطور یکی را فعال کنید و دقیقاً هر کدام چه ابزارهایی در اختیار می‌گذارد.

اتصال‌دهنده چیست

SitesAI دو سرور MCP منتشر می‌کند (Model Context Protocol — استاندارد بازی که دستیاران هوش مصنوعی برای دسترسی به سیستم‌های بیرونی به کار می‌برند). وقتی یکی را وصل کنید، می‌توانید به زبان ساده درباره داده‌های کارگاه خودتان از دستیار هوش مصنوعی سؤال کنید — «کدام پروژه‌ها پیش‌فاکتور دارند ولی هنوز زمان‌بندی نشده‌اند؟»، «در کارگاه Kilsyth چقدر خاک‌برداری کردیم؟» — و دستیار از سوابق زنده حساب شما پاسخ می‌دهد.

اتصال‌دهنده SitesAI App — داده‌های عملیات میدانی شما: سرنخ‌های فروش و پیش‌فاکتورها، وظایف، کارگاه‌ها، خدمات و اقلام، ساعات کار و شیفت‌های برنامه‌ریزی‌شده، برگه‌های کار امضاشده، اعضا، مدارک کارگاه و انطباق پیمانکاران فرعی، برچسب‌های NFC/QR، فرایندها و چک‌لیست‌ها. نقطه اتصال: https://app.sitesai.net/api/mcp/mcp (برای دسترسی به همه ابزارها ?profile=full را اضافه کنید — پروفایل‌های ابزار را ببینید)
اتصال‌دهنده SitesAI Estimate — پروژه‌های متره و برآورد شما: لایه‌های نقشه، شیت‌ها، گروه‌های متره، اجزای عملیات خاکی و خود برآورد. نقطه اتصال: https://takeoff.sitesai.net/api/mcp

هر دو از طریق HTTPS با MCP streamable HTTP کار می‌کنند و علاوه بر کلیدهای API شخصی، از OAuth 2.1 (کد مجوز + PKCE) هم پشتیبانی می‌کنند.

فعال کردن اتصال‌دهنده

اتصال‌دهنده‌ها به‌طور پیش‌فرض خاموش‌اند — تا وقتی خودتان آگاهانه یکی را وصل نکنید، هیچ چیزی با هیچ دستیار هوش مصنوعی به اشتراک گذاشته نمی‌شود.

طرح اشتراک خود را بررسی کنید. اتصال‌دهنده SitesAI App به افزونه هوش مصنوعی روی شرکت شما نیاز دارد و SitesAI Estimate به طرح هوش مصنوعی روی حساب شما — یا دوره آزمایشی رایگان 14 روزه هوش مصنوعی را در برنامه شروع کنید (منوی حساب → شروع آزمایش رایگان هوش مصنوعی؛ بدون نیاز به کارت، یک بار برای هر حساب).
اتصال‌دهنده را در کلاینت هوش مصنوعی خود اضافه کنید، با همان نقطه اتصال بالا، و سپس مراحل ورودی را که درخواست می‌کند کامل کنید. در SitesAI App صفحه رضایت فقط در دسترس مالکان و مدیران شرکت است و همان‌جاست که تعیین می‌کنید اتصال چه کاری می‌تواند انجام دهد — فقط خواندنی یا خواندن و نوشتن. دسترسی نوشتن هرگز خودکار نیست: تا وقتی مالک یا مدیر گزینه خواندن و نوشتن را در آن صفحه انتخاب نکند، اتصال فقط خواندنی است و همه ابزارهای نوشتن درخواست را رد می‌کنند.
یا از کلید API استفاده کنید — یک کلید در app.sitesai.net/ai-keys بسازید (در SitesAI Estimate: منوی حساب → دسترسی دستیار هوش مصنوعی (MCP)) و آن را در کلاینت هوش مصنوعی خود وارد کنید. هر کلید می‌تواند فقط خواندنی یا خواندن و نوشتن باشد و به یک شرکت تعلق دارد.

SitesAI Estimate، کلاینت به کلاینت

نشانی اتصال‌دهنده https://takeoff.sitesai.net/api/mcpاست. تا وقتی دستیار کار می‌کند، یک زبانه SitesAI Estimate را در حالت واردشده باز نگه دارید — تغییرات جلوی چشمتان نمایش داده می‌شوند.

Claude (claude.ai یا برنامه دسکتاپ) — Settings → Connectors → Add custom connector → نشانی را وارد کنید → با حساب کاربری SitesAI Estimate خود وارد شوید. بدون نیاز به توکن.
Claude Code — claude mcp add --transport http 3dx https://takeoff.sitesai.net/api/mcp؛ یک پنجره مرورگر برای ورود باز می‌شود.
Codex (دسکتاپ) — در برنامه: منوی حساب → دسترسی دستیار هوش مصنوعی (MCP) → ساخت توکن. در Codex: Connect to a custom MCP → Name 3DX، Type Streamable HTTP، نشانی، و یک هدر Authorization: Bearer <your token>.
Codex CLI — در ~/.codex/config.toml: [mcp_servers.threedx] url = "https://takeoff.sitesai.net/api/mcp" http_headers = { Authorization = "Bearer <your token>" }.
ChatGPT — Settings → Apps & Connectors → Advanced → Developer mode را روشن کنید → با این نشانی یک connector بسازید → وارد شوید. (نام منوها در 3 October 2026 بررسی شده است؛ این نام‌ها بین نسخه‌ها تغییر می‌کنند — نشانی و مراحل ورود تغییر نمی‌کنند.)

می‌خواهید دستیار هر بار پروژه‌ها را با نرخ‌ها و ضرایب خودتان قیمت‌گذاری کند؟ مقاله به Claude یا Codex یاد بدهید پروژه‌ها را به روش شما قیمت‌گذاری کند را بخوانید و مهارت آماده را دانلود کنید.

لغو دسترسی: همه کلیدها و همه اتصال‌های OAuth در app.sitesai.net/ai-keys فهرست شده‌اند و هر زمان قابل لغو هستند — و بلافاصله از کار می‌افتند.

دستیار متصل چه چیزهایی را می‌بیند و چه چیزهایی را نمی‌بیند

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

SitesAI App — ابزارها

اتصال‌دهنده App در مجموع 148 ابزار ارائه می‌کند: 71 ابزار خواندن و 77 ابزار نوشتن. همه آن‌ها در ادامه آمده‌اند.

پروفایل‌های ابزار. برخی میزبان‌های هوش مصنوعی برای تعداد ابزارهای یک اتصال‌دهنده سقف می‌گذارند، برای همین اتصال‌دهنده App یک زیرمجموعه انتخاب‌شده ارائه می‌دهد — عبارت ?profile= را به نشانی endpoint اضافه کنید. ops (91 ابزار) پیش‌فرض است و به رشته کوئری نیازی ندارد: مجموعه کار روزمره. lite (18 ابزار) مجموعه کوچک صندوق ورودی / دستیار تلفنی است، و full (148 ابزار) همه‌چیز است، از جمله ابزارهای ساخت و مدیریت. همان کلید، همان داده‌ها — فقط فهرست ابزارها فرق می‌کند، و همه ابزارهای این صفحه جزو این پروفایل‌اند: full.

ابزارهای خواندن (ایمن؛ هرگز چیزی را تغییر نمی‌دهند):

ابزار	کاربرد
`lookup_by_phone`	این شماره تلفن مال کیست؟ 9 رقم آخر را در مخاطبان CRM، حساب‌ها، اعضای شرکت و سرنخ‌های فروش تطبیق می‌دهد. در هر تماس/پیامک ورودی اول این را فراخوانی کنید…
`call_brief`	تنها فراخوانی لازم وقتی تلفن زنگ می‌خورد (g240): شماره را یک‌بار شناسایی می‌کند (9 رقم آخر، مانند lookup_by_phone) و `brief` را برمی‌گرداند — متنی از پیش آماده…
`get_job_detail`	خوانش عمیق و متمرکز یک پروژه، در حالی که تماس‌گیرنده پشت خط است (g240 بخش 2): سرنخ فروش به‌طور کامل (follow_up_txt = پیگیری بعدی)، تصویر قرارداد آن…
`search_records`	جستجوی سراسری در همه سوابق شرکت با یک فراخوانی — سرنخ‌های فروش (شماره پروژه/نام/مشتری)، پیش‌فاکتورها، وظایف، نظرات/یادداشت‌های دفتر روزانه (شامل پیوست‌های عکس/فایل —…
`list_activity`	دفتر رویدادهای شرکت: هر آنچه در یک بازه زمانی رخ داده، از جدیدترین — وظایف ایجادشده/انجام‌شده/تأییدشده، سرنخ‌های فروش ایجادشده و جابه‌جایی مرحله‌ها، نظرات (…
`company_overview`	نمای کلی شرکت با یک فراخوانی: آمار داشبورد، قیف سرنخ‌های فروش (باز/سررسید/برنده + تعداد به تفکیک مرحله)، دسته‌های وظایف، منطقه زمانی شرکت (همه رشته‌های تاریخ/زمان…
`get_phone_agent_config`	پیکربندی دستیار تلفنی SitesAI Voice این شرکت — خوشامدگویی، رفتار، ابزارهای مجاز، مشخصات کسب‌وکار، منطقه زمانی و سرویس‌های فعال: آنچه دستیار صوتی/پیامکی…
`list_leads`	فهرست سرنخ‌های فروش CRM (قیف فروش). فیلتر بر اساس متن جستجو، مرحله دقیق، دسته (live/won/closed) یا due=true برای پیگیری‌هایی که الان سررسید شده‌اند. توجه: سرنخ فروشی که در…
`get_lead`	یک سرنخ فروش به‌طور کامل: همه فیلدها (شامل lead_ref، شماره پروژه‌ای که کاربر می‌بیند) به‌همراه مخاطبان پیوست‌شده (افرادی از هر شرکت، که یکی به‌عنوان اصلی علامت خورده)، فعالیت…
`list_lead_types`	انواع سرنخ فروش شرکت — دسته‌های قابل‌تعریفی که هر سرنخ فروش به یکی از آن‌ها تعلق دارد (برچسب‌هایشان فیلدهای عمومی متن/تاریخ/عدد را برای سرنخ‌های آن نوع فعال می‌کند…
`list_quotes`	فهرست پیش‌فاکتورهای مشتری (draft/sent/accepted/rejected/cancelled) با جمع کل. فیلتر بر اساس وضعیت، سرنخ فروش یا متن جستجو. cancelled = پذیرفته شده بود، سپس…
`get_quote`	یک پیش‌فاکتور به‌طور کامل: سربرگ، همه ردیف‌ها (مقدار/واحد/نرخ/GST، منشأ 3DX)، جمع‌ها (بدون GST / GST / با GST)، لینک اشتراک مشتری پس از ارسال، و `sent_…
`list_tasks`	فهرست وظایف شرکت. فیلتر بر اساس وضعیت (open/done/approved)، ایمیل مسئول، متن جستجو، یا due=true برای وظایفی که الان سررسید شده‌اند.
`list_sites`	فهرست کارگاه‌ها/محل‌های کار شرکت (پروژه‌ها، تعمیرگاه‌ها، انبارها، دفاتر). جستجوی q روی نام، نشانی، مرجع پروژه و تلفن کار می‌کند (چندکلمه‌ای…
`list_services`	فهرست کاتالوگ خدمات + قیمت‌گذاری شرکت (برای قیمت‌دهی به مشتری و پشتیبانی). هر خدمت: نام، توضیح، دسته (parent_name)، و نرخ + …
`list_items`	فهرست اقلام/تجهیزات/موجودی شرکت. جستجوی q روی نام، شماره قطعه، برند و توضیح کار می‌کند (چندکلمه‌ای). از flag="hire" یا flag="sale" برای…
`get_item`	دریافت یک قلم با item_id — جزئیات کامل شامل stock_type، for_hire / for_sale، قیمت، واحد، دسته، item_code و مقادیر جایگزین حساب، و برای اقلام ردیابی‌شده…
`get_purchase_order`	دریافت یک سفارش خرید با po_id — تأمین‌کننده، کارگاه تحویل، وضعیت (draft \| quote \| ordered \| received \| cancelled) و همه ردیف‌ها. هر ردیف شامل…
`list_accounts`	فهرست حساب‌های CRM (شرکت‌های مشتری/تأمین‌کننده). جستجوی q روی نام، نوع، صنعت، کارگاه، وب‌سایت و تلفن کار می‌کند (چندکلمه‌ای، بدون وابستگی به ترتیب).
`get_account`	یک حساب CRM به‌طور کامل، همراه با مخاطبان و سرنخ‌های فروش آن.
`list_contacts`	فهرست مخاطبان CRM (افراد). جستجوی q روی نام، نقش/عنوان، ایمیل، شرکت و تلفن کار می‌کند (چندکلمه‌ای، بدون وابستگی به ترتیب). برای جستجوی صرفاً با شماره تلفن…
`list_worktime`	شیفت‌های خدمه — چه کسی کجا کار کرده / ثبت ورود کرده است. ردیف‌ها شامل planned_start/finish (پیشنهاد پذیرفته‌شده برنامه کاری، برای مقایسه برنامه با واقعیت) و امضا…
`worktime_summary`	مجموع ساعت‌ها برای یک بازه تاریخ — پاسخ به "Sam ماه گذشته چند ساعت کار کرد" یا "چقدر زمان صرف آن کارگاه شد"، بدون فهرست کردن شیفت‌ها…
`list_action_entries`	ورودی‌های ثبت‌شده KPI/عملیات — دفتر عملیات شرکت (بارهای کامیون، استقرار در گود، تحویل‌ها…). هر ردیف یک رکورد: زمان ثبت، مقدار، مصالح، ماشین…
`list_action_offers`	عملیات متصل به پیمانکار جزء (DDL 136): میزبان یکی از انواع عملیات KPI خود را در یکی از کارگاه‌هایش به یک شرکت مجاز پیشنهاد می‌دهد (company_own…
`list_dockets`	برگه‌های کار امضاشده (DDL 122؛ از DDL 143 به بعد یکی برای هر کامیون — machine_key = همان unit_id، در غیر این صورت پلاکی که راننده ماشین‌آلات وارد کرده به‌صورت نرمال‌شده (XV96OD)، و در غیر این صورت '' وقتی…
`get_docket`	یک برگه کار به‌طور کامل: سربرگ، بخش‌های امضا + تأیید، و ردیف‌های آن — ورودی‌های زنده تا وقتی باز است، و نسخه ثابت‌شده پس از امضا (هرگز دوباره محاسبه…
`list_shifts`	شیفت‌های برنامه‌ریزی‌شده (برنامه کاری/تقویم): پیشنهادها به اعضا با وضعیت offered \| accepted \| rejected (reject_reason دلیل را می‌گوید) \| cancelled \| expired (…
`get_shift`	یک شیفت برنامه‌ریزی‌شده به‌طور کامل (وضعیت، بازه زمانی، یادداشت، دلیل رد، پاسخ‌دهنده، planned_actions = برنامه روز).
`list_no_shows`	بررسی همان روز: شیفت‌های پذیرفته‌شده در امروزِ به وقت محلی کارگاه که از مهلت 15 دقیقه‌ای شروعشان گذشته و هیچ ثبت ورودی ندارند — 'در برنامه هست ولی حاضر نیست'. در صورت نیاز فیلتر…
`calendar_events`	تقویم شرکت در یک فراخوانی: شیفت‌های برنامه‌ریزی‌شده، سررسید کارها، پیگیری‌های سرنخ فروش و انقضای مدارک برای یک بازه تاریخی (به‌علاوه آنچه صفحه /calendar…
`list_members`	اعضای شرکت که می‌توان سرنخ‌های فروش و کارها را به آن‌ها سپرد (ایمیل + نام نمایشی + ui_lang = زبانی که آن فرد برنامه را با آن می‌بیند، null = زبان گوشی…
`list_processes`	پایگاه دانش عملیات: فهرست فرایندهای شرکت. در Flows v2، هر فرایند یک فهرست مرتب از SOPهای کتابخانه مشترک SOP شرکت است (list_so…
`get_process`	یک فرایند با گام‌های مرتبش (هر گام = یک SOP کتابخانه در یک جایگاه: sort_order، step_id، به‌علاوه used_in = فرایندهای دیگری که از آن استفاده می‌کنند)، هر گ…
`get_sop`	یک SOP به‌طور کامل (ورودی/خروجی/نقش/دستورالعمل، رسانه، چک‌لیست‌ها، action_type/action_config اجرایی، گام‌های بعدی قدیمی) به‌علاوه used_in = همه فرای…
`list_flow_assignments`	فهرست تخصیص‌های روند راهنما — کدام اعضا/نقش‌ها کدام ویزارد فرایند را دنبال می‌کنند.
`list_flow_runs`	اجراهای روند راهنما — چه کسی کدام روند را کی طی کرد، گام فعلی، گام‌های انجام‌شده. status: in_progress (دور باز است) \| completed (تا انتها طی شده) \| aba…
`get_flow_run`	یک اجرای روند راهنما به‌طور کامل: خود اجرا، گام فعلی و هر گام تکمیل‌شده با آنچه ایجاد کرده (ارجاع به شیفت/کار/نظر).
`list_tags`	برچسب‌های NFC / QR (DDL 131): یک برچسب فیزیکی حاوی https://app.sitesai.net/t/<code>. با لمس کارگر، برنامه باز می‌شود و طبق کاربرد برچسب عمل می‌کند — برچسب کارگاه: …
`list_captures`	ثبت‌های سریع، خوراک میدانی‌اند: کارگر یک دکمه را می‌زند و یک عکس، یک پیام صوتی یا یک خط متن همراه با GPS ثبت می‌کند — بدون انتخاب هیچ رکوردی. هر کدام با وضعیت…
`get_capture`	یک ثبت سریع به‌طور کامل، به شکلی که برای تصمیم درباره جای آن لازم دارید: رکورد JSON (مانند list_captures، به‌علاوه hints.nearest — حداکثر 5 مورد از…
`list_doc_types`	انواع مدارکی که شرکت می‌تواند استفاده کند — انواع مشترک سیستمی (مجوز، گواهی، بیمه، SWMS (دستورالعمل کار ایمن)، کارت سفید، گواهی آموزش ورود به کارگاه، سایر) به‌علاوه انواع…
`get_site`	یک کارگاه به‌طور کامل. در نقش مالک: جزئیات (نشانی، منطقه زمانی، حصار جغرافیایی، ساعات)، آموزش ورود به کارگاه، document_requirements، granted_companies (پیمانکاران جزء)،…
`list_site_document_requirements`	مدارکی که یک کارگاه می‌خواهد: یک ردیف برای هر (نوع مدرک × دامنه) — دامنه company (بیمه…)، member (مجوزها/کارت‌های هر فرد)، unit (هر دستگاه…
`site_compliance`	چه کسی در چه چیزی نامنطبق است، همین حالا: هر خانه الزام × موضوع در یک کارگاه (شرکت / عضو / دستگاه) با مدرک ارسال‌شده، وضعیت آن…
`compliance_overview`	وضعیت انطباق شرکت در یک نگاه: مدارک رو به انقضا (مدارک خود شرکت + مدارک به اشتراک گذاشته‌شده با آن، فقط دارندگان فعال)، مدارک ارسالی در انتظار بررسی شما (به‌عنوان مالک کارگاه…
`list_documents`	مدارکی که شرکت می‌تواند ببیند، در یک فهرست: مدارک خودش (relation company)، مدارک اعضایش (member — هر ارتباط فعال)، مدارک دستگاه‌هایش (unit) و مدار…
`get_file`	باز کردن فایل پیوست‌شده به هر رکورد — مقدار photo_path / file_path / signature_path را دقیقاً همان‌طور که ابزار دیگری برگردانده بفرستید (نظرها، ثبت‌های عملیات…
`list_files`	همه فایل‌های پیوست‌شده به رکوردهای شرکت، جدیدترین‌ها اول — عکس‌ها / فایل‌ها / پیام‌های صوتی نظرها، ثبت‌های سریع میدانی که هنوز بایگانی نشده‌اند (source ca…
`list_maintenance_logs`	گزارش‌های نگهداری برای هر دستگاه: kind = prestart (بازرسی پیش از شروع — چک‌لیست روزانه‌ای که کارگر پیش از استفاده از دستگاه ثبت می‌کند؛ ردیف‌های نقص یک کار بررسی ایجاد می‌کنند) \| s…
`get_maintenance_log`	یک گزارش نگهداری / بازرسی پیش از شروع به‌طور کامل: سربرگ (دستگاه، چه کسی، چه زمانی، کارکردسنج، سوخت، کارگاه، یادداشت‌ها، photo_path + signature_path در سطح گزارش) و…
`get_flow_design_guide`	پیش از طراحی یا ویرایش فرایندها، اول این را بخوانید: اینکه SOPها (کتابخانه مشترک)، فرایندها (فهرست‌های مرتب SOP) و روندها (اجراهای ویزارد کارگر) چگونه کنار هم…
`list_step_types`	کاتالوگ انواع گامی که یک SOP می‌تواند داشته باشد (action_type): کار هر کدام در ویزارد کارگر، کلیدهای action_config آن (kind، required، defaults، options…
`list_sops`	کتابخانه SOP شرکت — هر SOP یک بار، همراه با فرایندهایی که گامی از آن‌هاست (used_in). SOPها اجزای مشترک‌اند: همان "ثبت ورود" می‌تواند…
`list_flow_offers`	فرایندهایی که شرکت‌های میزبان در کارگاه‌هایی که شرکت من به آن‌ها دسترسی دارد ارائه می‌کنند (نمای پیمانکار جزء از "کار برای <host>"): میزبان، کارگاه، اینکه آیا ما از قبل…
`list_jobs`	پروژه‌های فعال — سرنخ‌های فروشی که به مرحله برنده‌شده رسیده‌اند، به‌عنوان کار دیده می‌شوند نه فروش. هر ردیف تصویر عملیاتی را کنار وضعیت تجاری…
`get_job`	یک پروژه با جزئیات عملیاتی: کارگاه(هایی) که کار در آن انجام می‌شود (از CoSites.lead_id)، و برای هر کدام خدمه (CoSiteMember — چه کسی تخصیص یافته، …
`list_contracts`	اسناد قرارداد صادرشده برای یک پروژه (DDL 141). از نظر قانونی، پیش‌فاکتور پذیرفته‌شده خودش قرارداد است — مشتری نامش را در صفحه اشتراک پیش‌فاکتور تایپ کرده…
`list_stock_moves`	دفتر موجودی — هر جابه‌جایی مصالح، قطعات، اقلام مصرفی یا سوخت، هر کدام در یک ردیف. qty علامت‌دار است: مثبت یعنی ورودی (خرید، افزایش در شمارش، انتقال…
`list_stock_locations`	جایی که موجودی به‌طور فیزیکی قرار دارد: محوطه‌ها، انبارهای داخل کارگاه‌ها، مخازن سوخت (مختص یک قلم، با ظرفیت مشخص)، خودروها (کامیون سرویس). محلی که ثابت…
`get_stock_levels`	مقدار هر قلم در هر محل، ارزش‌گذاری‌شده با میانگین موزون بهای آن قلم (value = qty × avg_cost). فیلتر بر اساس item_id یا location_id. مقدار منف…
`get_stock_location`	یک محل با سطوح موجودی و فعالیت‌هایش: سطح در برابر ظرفیت، آخرین تحویل، آخرین شمارش یا اندازه‌گیری مخزن و مغایرت آن، آنچه در 30 روز گذشته مصرف شده و…
`get_job_costs`	آنچه یک پروژه (lead_id) از موجودی مصرف کرده و به‌عنوان خرید هزینه‌شده به آن منظور شده — مقدار و ارزش هر قلم و جمع کل — از دفتر موجو…
`get_work_model_guide`	برای هر پرسشی درباره اینکه شرکت چه کاری انجام می‌دهد، چه کسی آن را انجام می‌دهد، دامنه کار یک پروژه چیست یا چه مقدار انجام شده، اول این را بخوانید: اینکه خدمات (آنچه می‌فرو…
`preview_member_view`	آنچه این عضو هنگام باز کردن برنامه خواهد دید — از نگاه برنامه‌ریز. خروجی: menu = منویی که وارد آن می‌شوند، مورد به مورد، با گروهی که هر مورد زیر…
`get_worktime`	یک شیفت به‌طور کامل — شیء روز: { shift (ردیف list_worktime شامل دو امضا، prestart_count، material_count)، operations (ثبت‌هایی…
`list_prestart_due`	دستگاه‌هایی (واحدهای دارایی) که هنوز بازرسی پیش از شروع امروز را لازم دارند: واحدی با دست‌کم یک تعریف فعال بازرسی پیش از شروع و بدون هیچ گزارش بازرسی پیش از شروع تا این لحظه در…
`list_actions`	انواع عملیات شرکت (actions) — واحدهای کار ثبت‌شده پشت list_action_entries، برگه‌های کار و KPIها (مثلاً "بارگیری کامیون"، "ساعت کار دستگا…
`list_action_assignments`	تخصیص‌های ثابت انواع عملیات شرکت (DDL 137): هر ردیف یک action را دقیقاً به یکی از این‌ها وصل می‌کند: یک عضو (وظیفه ثابت او — "او…
`list_sow_items`	شرح کار یک قرارداد (قرارداد همان سرنخ فروش است — list_leads/get_lead را ببینید). هر مورد یا kind="scope" است (کارهای توافق‌شده، معمولاً…
`list_progress_claims`	گزارش‌های صورت‌وضعیت یک قرارداد (DDL 140): از شرح کار توافق‌شده و دستورکارهای تأییدشده، تا امروز چه مقدار انجام شده و ارزش آن چقدر است، منهای…

ابزارهای نوشتن (فقط با کلید یا اتصال خواندن و نوشتن در دسترس‌اند؛ هر کدام فقط یک کار مشخص و محدود انجام می‌دهد). این ابزارها سه نوع‌اند و نوع هر ابزار به‌صورت یک برچسب MCP قابل‌خواندن برای ماشین روی آن ثبت شده است، تا دستیار هوش مصنوعی شما پیش از اجرای هر ابزار بداند از کدام نوع است:

افزودن مورد جدید — یک رکورد می‌سازد و چیزی را بازنویسی نمی‌کند (با برچسب غیرمخرب): create_lead, create_lead_type, create_quote, add_quote_line, create_account, create_contact, offer_action, add_comment, create_process, create_sop, add_sop_next, create_checklist, assign_flow, register_tag, file_capture, create_doc_type, create_document, submit_document, assign_to_site, grant_site_company, add_process_step, start_flow_offer, create_job_site, create_contract, record_stock_use, create_action, assign_action, plan_shift_actions, create_sow_item, import_quote_sow, issue_progress_claim.

تغییر یا حذف مورد موجود — با برچسب مخرب، تا دستیار هوش مصنوعی شما بتواند پیش از اجرا از شما بپرسد: attach_lead_contact, detach_lead_contact, update_lead_type, update_quote_line, delete_quote_line, update_account, delete_account, update_contact, delete_contact, update_worktime, delete_lead, delete_task, update_comment, delete_comment, update_process, update_sop, remove_sop_next, unassign_flow, revoke_tag, update_capture, update_doc_type, set_site_document_requirements, review_submission, revoke_site_company, remove_process_step, move_process_step, set_process_steps, delete_process, delete_sop, void_contract, update_action, update_sow_item, unassign_action.

رسیدن به فردی بیرون از برنامه — این ابزارها علاوه بر تغییر رکورد، به کسی ایمیل یا اعلان می‌فرستند، پس با برچسب مخرب و جهان‌باز مشخص شده‌اند (پیام فرستاده‌شده قابل بازگشت نیست): update_quote, create_task, create_shift, respond_shift, cancel_shift, reoffer_shift, create_shifts_bulk, reassign_shift, update_lead, update_task, add_member, send_contract_for_signature, send_variation_for_approval.

SitesAI Estimate — ابزارها

ابزار	کاربرد	نوع
`get_project_summary`	دریافت خلاصه پروژه	خواندن
`list_layers`	فهرست لایه‌های نقشه	خواندن
`list_sheets`	فهرست برگه‌های طراحی	خواندن
`list_takeoffs`	فهرست گروه‌های متره	خواندن
`list_elements`	فهرست اجزای عملیات خاکی	خواندن
`get_estimate`	دریافت برآورد	خواندن
`get_page_image`	تبدیل نقشه به تصویر	خواندن
`get_ai_authoring_context`	دریافت زمینه نگارش هوش مصنوعی	خواندن
`apply_delta`	ترسیم متره‌ها / اجزا (اعمال تغییرات)	نوشتن
`manage_sheets`	افزودن، تغییر نام یا فعال‌کردن برگه	نوشتن
`add_layer_from_url`	افزودن لایه نقشه از URL	نوشتن
`calibrate_layer_scale`	کالیبره‌کردن مقیاس لایه	نوشتن
`align_layer`	هم‌ترازکردن لایه روی نقشه	نوشتن
`update_estimate`	ویرایش برآورد	نوشتن — غیرقابل بازگشت
`run_auto_takeoff`	اجرای متره خودکار با بینایی هوش مصنوعی	نوشتن
`run_vector_takeoff`	اجرای متره برداری قطعی	نوشتن
`list_cad_layers`	فهرست لایه‌های CAD یک صفحه	خواندن
`delete_takeoff`	حذف گروه متره	نوشتن — غیرقابل بازگشت
`save_project`	ذخیره پروژه	نوشتن
`new_project`	شروع پروژه جدید (حالت پس‌زمینه)	نوشتن — غیرقابل بازگشت
`open_project`	بازکردن پروژه ‎.3dx (حالت پس‌زمینه)	نوشتن — غیرقابل بازگشت
`add_layer_from_data`	افزودن لایه نقشه از بایت‌های فایل	نوشتن

SitesAI Estimate می‌تواند زنده در زبانه باز مرورگر شما اجرا شود (تغییرات همان لحظه که دستیار انجامشان می‌دهد نمایش داده می‌شوند) یا در حالت پس‌زمینه و بدون زبانه. نکات فنی بیشتر در مستندات MCP محصول آمده است.

چه بپرسید

“کدام سرنخ‌های فروش این ماه آمدند و کدام‌یک هنوز پیش‌فاکتور ندارند؟”
“چه کسی فردا در کارگاه Ringwood شیفت دارد و آیا امروز کسی غیبت داشت؟”
“ساعات کار ثبت‌شده برای پروژه 142 در هفته گذشته را خلاصه کن.”
“کدام برگه‌های کار هفته گذشته هنوز امضا نشده‌اند و راننده ماشین‌آلات هر کدام چه کسی بود؟”
“گواهینامه‌ها و بیمه‌های چه کسانی در 30 روز آینده منقضی می‌شوند و کدام کارگاه‌ها از این بابت کمبود دارند؟”
“نقشه Kilsyth من را باز کن، مقیاس را با نوار 10 m کالیبره کن و حجم خاک‌برداری و خاکریزی را به من بده.”
“ردیف خاک‌برداری عمومی را با نرخ $28/m³ قیمت‌گذاری کن و جمع کل جدید برآورد را نشانم بده.”

پاسخ به پرسش‌های شما

آیا می‌توانم متره عملیات خاکی را از ChatGPT یا Claude انجام دهم؟

بله. SitesAI Estimate را به‌عنوان کانکتور (با آدرس https://takeoff.sitesai.net/api/mcp) در Claude، Claude Code، Codex یا ChatGPT وصل کنید. بعد یک تب SitesAI Estimate را که در آن وارد حساب خود شده‌اید باز بگذارید و درخواست‌تان را بنویسید. دستیار با ابزارهای فهرست‌شده در بالا پروژه را باز می‌کند، نقشه را کالیبره می‌کند، متره را ترسیم می‌کند و ردیف‌ها را قیمت‌گذاری می‌کند. هر تغییر در تب شما نمایش داده می‌شود تا پیش از صدور پیش‌فاکتور آن را بررسی کنید.

کدام دستیارهای هوش مصنوعی با SitesAI کار می‌کنند؟

Claude (claude.ai و اپ دسکتاپ)، Claude Code، Codex (دسکتاپ و CLI) و ChatGPT در Developer mode، با همان مراحل بالا. هر کلاینت دیگری که از MCP روی streamable HTTP پشتیبانی کند، به همین روش وصل می‌شود.

کدام پلن شامل کانکتور است؟

در SitesAI Estimate، کانکتور بخشی از پلن AI است (ماهانه US$99 برای هر کاربر، با 14 روز آزمایش رایگان و بدون نیاز به کارت). در SitesAI App، کانکتور با افزونه AI ارائه می‌شود: ماهانه US$38 برای کل شرکت. جزئیات پلن‌ها در صفحه قیمت‌ها آمده است.

آیا دستیار متصل می‌تواند داده‌های شرکت دیگری را ببیند؟

خیر. هر کلید یا مجوز دسترسی فقط به یک شرکت تعلق دارد و سرورهای ما هر درخواست را به همان شرکت محدود می‌کنند. ابزارهای خواندن و نوشتن از هم جدا هستند و درخواست‌ها در گزارش ممیزی AI شرکت ثبت می‌شوند. هر کلید یا اتصال را می‌توانید در app.sitesai.net/ai-keys لغو کنید؛ دسترسی آن بلافاصله قطع می‌شود.

پشتیبانی

در اتصال مشکل دارید، یا ابزاری کاری غیرمنتظره انجام می‌دهد؟ به admin@sitesai.net ایمیل بزنید — معمولاً ظرف یک روز کاری پاسخ می‌دهیم. همچنین صفحه پشتیبانی و سیاست حریم خصوصی ما را ببینید.