Skip to content

Connect an AI assistant ​

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

Built

DutyGraph speaks the Model Context Protocol (MCP) over HTTP. Any MCP client can connect to one endpoint:

text
https://dutygraph.com/api/mcp
Your AI assistantClaude, ChatGPT,Cursor, Claude Codedutygraph CLIa terminalDutyGraph MCP server/api/mcpchecks the token and its scopesRecordsone workspace,its companies onlyCompany Repofiles to readtokentokenRead, Write and Send email are separate permissions.A token can be limited to chosen companies.
An assistant or the CLI calls one MCP endpoint with a token. The server checks what the token may do before it reads or changes a record.

By client ​

ClientHow
Claude Codeclaude mcp add --transport http dutygraph https://dutygraph.com/api/mcp --header "Authorization: Bearer dgp_..."
Claude.ai and Claude DesktopSettings › Connectors › Add custom connector. Enter the URL, then sign in.
ChatGPTSettings › Connectors › Create. Enter the same URL, then sign in.
Cursor and other clientsAdd an HTTP server with the URL and an Authorization: Bearer dgp_... header.
json
{
  "mcpServers": {
    "dutygraph": {
      "url": "https://dutygraph.com/api/mcp",
      "headers": { "Authorization": "Bearer dgp_..." }
    }
  }
}

A company's administrator may need to allow custom connectors before employees can add one.

Three surfaces, one protocol ​

SurfaceWho uses itEndpointCredential
Advisor toolsAn advisor's AI assistantPOST /api/mcpBrowser sign-in, or a dgp_ token with read, write and optionally send_email
Employee toolsAn employee's own AI chatPOST /api/mcpBrowser sign-in, bound to that one person
Agent gatewayAn issued agentPOST /api/mcp/agentOne dga_ credential per issued agent

They never share a token.

What the tools will not do ​

  • No tool decides. No tool approves, changes or denies an agent request. Those decisions happen in the DutyGraph app.
  • No tool goes around the app. Each advisor tool calls the same server route as the app, as the person who owns the token.
  • Writes preview first. Imports and fills return a preview unless you pass apply: true.
  • Email needs its own scope. write never sends email.

Next ​

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