Skip to content

Sign-in and tokens ​

This page is for: advisors, forward-deployed engineers and developers who connect AI tools or the CLI.

There are two ways to prove who you are: browser sign-in (OAuth) or a personal token. Both reach the same tools.

Browser sign-in ​

Built

MCP clients that support OAuth find DutyGraph's sign-in at /.well-known/oauth-authorization-server. You approve the connection in DutyGraph and the client gets a token for you.

  • An advisor gets read and write.
  • An employee gets share_work, bound to their own person record. A leader also gets share_strategy.
  • The CLI uses this flow with a callback on your own machine.

Browser sign-in never grants email sending.

Personal tokens ​

Built

Create one in Settings › MCP access. It starts with dgp_. DutyGraph shows it once and stores only its SHA-256 hash. Revoke stops a token at once. A token cannot create or revoke tokens.

Settings, MCP access, Create a key. Set a name, when it expires, which companies it reaches and what the assistant can do.
Settings, MCP access, Create a key. Set a name, when it expires, which companies it reaches and what the assistant can do. Sample company, fictional data.
Keys and connections: each key with its scopes, dates and status. Revoke stops a key at once.
Keys and connections: each key with its scopes, dates and status. Revoke stops a key at once. Sample company, fictional data.
ScopeWhoWhat it allows
readAdvisorAlways on. Companies, accounts, research status, the Company Snapshot, Company Repo files and drafts.
writeAdvisorAdd accounts and people, import CSV files, start research, fill onboarding, save drafts. It does not send email.
send_emailAdvisorOff by default. Sends a prepared draft. Turn it on only if you review each draft first.
share_workEmployeeSend Task Card drafts for your own work
share_strategyLeaderSend Strategy Card drafts
request_agentsEmployeeAsk for an agent inside your own access

The employee scopes are bound to one person and never combine with the advisor scopes.

Tokens expire after 30 days, 90 days (the default), 1 year, or never.

Limit a token to chosen companies ​

Built

By default an advisor token reaches every company in its workspace.

When you create a key in Settings › MCP access, Companies offers All companies in this workspace or Only the company that is open. A limited token lists only those companies. Any other company answers NOT_FOUND, and tools that add companies answer TOKEN_COMPANY_LIMIT.

Send the token ​

http
POST /api/mcp
Authorization: Bearer dgp_...

Keep tokens out of files you commit. Use an environment variable such as DUTYGRAPH_TOKEN.

DutyGraph. Pages label each feature Built, In review or Planned.