Docs/Docs Home
DocumentationSetup · Configuration · Reference · Troubleshooting

Nunc Documentation

Instructions for setting up your Nunc tenant, configuring connectors and Guardian policies in console.nunc.cloud, and using governed tools from Claude, Cursor, ChatGPT, Data Studio Web, Slack, or @nunc/sdk.

5-minute setup checklist

  1. Bind SSO & groups in Console: Sign in to https://console.nunc.cloud, open Organization → Users, and connect Okta, Microsoft Entra ID, or Google Workspace so users inherit department groups.
  2. Enable a connector or warehouse: Open Build → Integrations to enable SaaS apps (Outlook, Salesforce, Slack, Sage Intacct) or bind a read-only Snowflake/PostgreSQL role and set each table to Allow Agent, Scope to User, or Block.
  3. Grant default-deny tool rules: Open Organization → Access and set read tools (list_*, get_*) to Allow and write tools (send_*, create_*, update_*) to Gate (Require Approval).
  4. Connect your AI client or open Data Studio: Launch https://studio.nunc.cloud in the browser, or register Nunc's MCP endpoints in Claude / Cursor:
# 1. Register governed SaaS tools (e.g. Outlook + Salesforce) in Claude Code
claude mcp add --transport http nunc "https://api.nunc.cloud/mcp?apps=outlook,salesforce"

# 2. Register read-only warehouse SQL analytics
claude mcp add --transport http nunc-analytics "https://api.nunc.cloud/mcp/analytics"

# 3. Verify connected endpoints
claude mcp list

Guides by product

Direct links to setup instructions, configuration schemas, and references for each Nunc product.

Getting Started

Nunc MCP & Connectors

Nunc Guardian

Private Agents & @nunc/sdk

Data Studio & Sidecar

Console & Operations

Production endpoints & authentication

ServiceEndpoint URLAuthURL Filter Example
Tools MCPhttps://api.nunc.cloud/mcpOAuth 2.1 PKCE / Federated App Key?apps=outlook,salesforce
Analytics MCPhttps://api.nunc.cloud/mcp/analyticsHuman OAuth 2.1 PKCE?warehouse=prod_snowflake
Sandbox MCPhttps://api.nunc.cloud/mcp/sandboxHuman OAuth 2.1 PKCEAir-gapped Python / TS
Memory MCPhttps://api.nunc.cloud/mcp/memoryHuman OAuth 2.1 PKCE?workspace=finance-close
Delegate MCPhttps://api.nunc.cloud/mcp/delegateOAuth 2.1 PKCE / App Key?workspace=finance-close
Service APIhttps://api.nunc.cloud/serviceBearer nunc_* (type='service' App only)JSON-RPC tools/list & tools/call

Common issues & error codes

Symptom / StatusCauseFix
0 tools visible in clientNunc is default-deny; connecting an MCP client exposes zero tools until granted.Open Console -> Organization -> Access and set read tools to Allow and write tools to Gate.
401 invalid_tokenExpired OAuth session, wrong tenant URL, or revoked API key.Reconnect the MCP server to trigger OAuth 2.1 sign-in, or rotate your key in Build -> Integrations -> API Keys.
403 guardian_policy_blockedTool, table, or prompt was blocked by PBAC or Guardian firewall rules.Inspect the blocked trace in Console -> Trust -> Security -> Audit and adjust group access if intended.
409 approval_requiredMutating write tool (e.g. outlook_send_email, salesforce_update_*) paused at a write gate.Review the payload diff and click Approve in Console -> Trust -> Security, Data Studio, or Slack.
422 schema_mismatchSQL query referenced a Blocked table/column or attempted a non-SELECT statement.Set the table to Allow Agent or Scope to User in Build -> Integrations -> Databases.

Need support? Copy the trace ID from Console → Trust → Security → Audit and email support@nunc.cloud.