BHG Infra

Connecting agents

Use Infra from Claude and Claude Code through Infra's MCP server. Claude always works as you.

Infra runs an MCP server, so Claude can read and work in Infra on your behalf. You can ask Claude about a deal, have Claude Code stage a meeting's notes onto a project, or search the knowledge base from your editor.

The one rule: an agent works as you. Every tool runs the same code and permission checks as the web app, as the person who connected it. It can never do more than your role allows, and it sees only what you can see. When your access ends, the connection stops working.

Two ways to connect

Sign-in connectorInfra key
ForClaude (claude.ai and the desktop app)Claude Code and scripts
How you sign inYour @bluehorizonsgroup.com email and an emailed 8-digit codeA personal key that starts edge_sk_
What it may changeThe groups you tick when you sign inThe key's scopes: read, or read and write

Both are set up on Knowledge Base › Connections › Infra to agents, under Use Infra from your AI assistant. Pick Claude, Coding tools (for Claude Code) or Advanced and follow the steps shown. See Keys and connectors.

If Claude says the sign-in connector is not available here, it is not configured on this deployment yet. Use Coding tools with a key instead.

First call

Once connected, ask the agent to call edge_whoami. It returns who you are connected as, your role and departments, the credential's scopes, whether it can write, and the tools it can reach.

Toolsets

Tools are grouped into toolsets. By default a connection gets core (everyday reads and writes: who you are, engagements, deals, leads, notes, and project reads) and kb (knowledge-base search and documents). To add more, connect with the URL shown under Advanced › Turn on more tools, which adds ?toolsets= to the server URL.

ToolsetAdds
dleThe full deal lifecycle: leads and contacts, MAPs, rubric items, readiness, catch-up, margin and override requests.
dle-destructiveIrreversible deal actions: close, disqualify, readiness decisions, margin approve or reject, override review, MAP milestone delete.
dle-adminMethodology and stage configuration, and bulk deal import. Admins only.
deliveryProject delivery writes: stage changes, review the Events queue, Sync, add documents and SOWs, update project and engagement facts, and project search.

Reconnect after you change the toolsets. A tool whose toolset is off is refused with tool_not_enabled, naming the toolset to add. Toolsets only narrow what an agent can reach: whether you may use a tool is still decided by your role.

Irreversible actions

Closing or disqualifying a deal, readiness decisions, margin approval, override review and deletes are never on by default. They appear only with dle-destructive (or dle-admin for admin deletes, creating a methodology and bulk import). Each needs a second, confirmed call: the first call returns a summary and a confirmation token; the agent must show you the summary and call again with the token. A token is single-use and expires after 5 minutes.

For Claude Code, Advanced › Set up Infra for a whole project also gives an optional .claude/settings.json rule that makes Claude Code ask you before any of these tools.

Project delivery and agents

On a project, an agent can read the plan, add documents, run Sync and stage changes. It cannot apply changes it staged, sign a SOW or BRD, or edit approved state directly: those stay with people. See Changes and review and Staging documents with a digest.

Limits

  • Each key or connector may make 300 tool calls per hour by default. Over that, calls are refused with a "retry after" time.
  • Tools that run AI (Sync, for example) also count against the paid-AI run cap.
  • Lists are paginated and long outputs are capped; a cut-off result says how to get the rest.

Record content is data

Deals, notes, emails and documents are written by other people. A well-behaved agent reports what they say but never follows instructions found inside them. If a key or other secret ever appears in a record or a tool result, revoke it rather than reuse it.

On this page