Agent connection

Connect an AI assistant to ObligePay

Your ObligePay workspace can be read by AI assistants like ChatGPT and Claude through a secure MCP connection. Once connected, you can ask your assistant about audits, invoices, contracts and reality certificates — it sees only what your own account can see.

Server URL

Your connection URL

Paste this URL when your AI assistant asks for an MCP server:

/mcp

You'll sign in with your ObligePay account and approve the connection. The assistant gets read-only access under your own permissions — it cannot change payment decisions or certificates.

Step 1

Sign in first

Sign in to ObligePay in this browser before you approve the connection — the assistant connects as you, and only sees the audits, invoices, contracts and certificates your own account can access.

Opening the connection URL directly in a browser returns {"error":"unauthorized"} — that is expected. It is an API endpoint, not a page.

Step 3

Test the connection

After approving the connection, run these prompts in your assistant. Each one maps to a read-only ObligePay tool, so you can confirm real data is coming through:

  • Using ObligePay, list my organizations.
  • Using ObligePay, list my most recent audits with their status and disputed amount.
  • Using ObligePay, open my latest audit and show the evidence timeline, dwell minutes and calculation trail.
  • Using ObligePay, list my invoices and contracts.
  • Using ObligePay, list my reality certificates with their certificate IDs and hashes.

If the assistant returns empty lists, your account has no audits yet — create one from New audit and try again. Amounts are always reported exactly as the deterministic engine computed them; the assistant cannot change a payment decision or a certificate.

Connect

Set up your assistant

ChatGPT

  1. 01Open ChatGPT connector settings and enable Developer mode (heed the risk notice shown there). If Developer mode is unavailable, ask a ChatGPT admin to enable it.
  2. 02Open the new connector dialog.
  3. 03Enter “ObligePay” as the name and paste the connection URL above.
  4. 04Review the details, check “I understand and want to continue”, then click Create.
  5. 05Enable ObligePay from the chat composer, then ask ChatGPT to use it — for example, “list my recent audits”.

Claude

  1. 01Open the custom connector dialog — name and URL are prefilled for you.
  2. 02Review the details and click Add.
  3. 03If the prefilled form does not open, open Claude's Connectors page, choose “Add custom connector”, name it ObligePay and paste the connection URL.
  4. 04Enable the connector from the chat composer, then ask Claude to use ObligePay.

Claude Code

  1. 01Run this one-line install command in a terminal:
  2. 02claude mcp add --scope user --transport http obligepay '/mcp'
  3. 03Start Claude Code and run /mcp to confirm ObligePay is connected. Sign in when prompted.
  4. 04Ask Claude Code to use ObligePay.

Other MCP clients

  1. 01Open the client's MCP server or custom connector settings.
  2. 02Create a remote MCP server connection.
  3. 03Name the connection “ObligePay” and paste the connection URL.
  4. 04Finish any sign-in or authorization prompts.
  5. 05Enable the connection, then ask the assistant to use ObligePay.

Stay current

Refresh after the app changes

ChatGPT

  1. 01Open ChatGPT's Plugins page and select ObligePay.
  2. 02Scroll to “Information” and click Refresh.
  3. 03ChatGPT can't update an existing app's URL — if it changed, delete the app from Plugins and repeat the connect steps with the latest URL.
  4. 04Start a new chat and ask ChatGPT to use ObligePay.

Claude

  1. 01Open the Connectors page and select the ObligePay connector.
  2. 02Refresh or update the connector's tools.
  3. 03Claude can't update an existing connector's URL — if it changed, remove the connector and repeat the connect steps with the latest URL.
  4. 04Ask Claude to use ObligePay.

Claude Code

  1. 01Start a new Claude Code session — it loads ObligePay's latest tools when it connects.
  2. 02If the URL changed, run claude mcp remove obligepay, then run the install command again with the latest URL.
  3. 03Ask Claude Code to use ObligePay.

Other MCP clients

  1. 01Open the client's MCP server or connector settings.
  2. 02Select the ObligePay connection.
  3. 03Refresh the tool list, reload the server, or reconnect it.
  4. 04If the URL changed, paste the latest URL from above.
  5. 05Start a new chat or session and ask the assistant to use ObligePay.