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

اگر می‌خواهید برزمان را از یک اسکریپت، Claude Code یا کلاینت MCP دیگری به کار بگیرید، یک توکن دسترسی شخصی بسازید. برای ChatGPT و Claude به توکن نیازی نیست؛ آن‌ها با ورود امن OAuth وصل می‌شوند.

ساختن توکن

1. به تنظیمات ← حساب ← ورود و امنیت ← بات‌ها و اتصال‌ها ← توکن‌های دسترسی بروید و توکن تازه را بزنید.
2. نامی بدهید (مثلاً «اسکریپت گزارش») و دسترسی را انتخاب کنید: خواندن یا خواندن و نوشتن.
3. مدت اعتبار را بین ۷ تا ۳۶۵ روز انتخاب کنید؛ هر توکن حتماً تاریخ انقضا دارد.
4. توکن، که با bzp_ شروع می‌شود، فقط یک بار نشان داده می‌شود؛ آن را جای امنی نگه دارید.

Claude Code و کلاینت‌های MCP

نشانی سرور MCP همان https://mcp.barzaman.ir/mcp است. در Claude Code:

claude mcp add --transport http barzaman https://mcp.barzaman.ir/mcp

اگر کلاینت ورود OAuth را پشتیبانی نمی‌کند، سرآیند Authorization: Bearer bzp_… را با توکن خودتان بفرستید.

REST API

نشانی پایه https://api.barzaman.ir/v1/integrations است و هر درخواست سرآیند Authorization: Bearer bzp_… می‌خواهد.

درخواست	کار
GET /today	خلاصهٔ امروز
GET /items?range=today	فهرست کارها؛ range یکی از today، tomorrow، week، overdue یا custom (با from و to)
GET /items/search?q=…	جست‌وجو
POST /items با بدنهٔ {"text": "..."}	ساختن کار از یک جملهٔ عادی
POST /items/{id}/complete	انجام شد
POST /items/{id}/snooze	عقب انداختن

نمونه:

curl -H "Authorization: Bearer bzp_…" https://api.barzaman.ir/v1/integrations/today

امنیت

• توکن‌ها رمزنگاری‌شده نگه‌داری می‌شوند و دوباره نشان داده نمی‌شوند؛ آخرین زمان استفادهٔ هر توکن در فهرست دیده می‌شود.
• کمترین دسترسی لازم را بدهید؛ اسکریپتی که فقط گزارش می‌گیرد با «خواندن» کارش راه می‌افتد.
• هر توکنی را که دیگر لازم ندارید یا ممکن است لو رفته باشد، با لغو همان لحظه از کار بیندازید.