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
- 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. - 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, orBlock. - 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). - Connect your AI client or open Data Studio: Launch
https://studio.nunc.cloudin 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 listGuides by product
Direct links to setup instructions, configuration schemas, and references for each Nunc product.
Getting Started
- Using Nunc: User & Team Guide
Daily workflows across Data Studio Web, Claude/Cursor MCP, Slack, and write approvals.
- How Configuration Works
The 5-layer Console policy model, warehouse SQL setup, table scoping, and PBAC.
- Platform Architecture
Single-tenant database, vector index, encrypted vault, and runtime isolation.
Nunc MCP & Connectors
- Connect MCP Clients
Register Nunc in Claude, ChatGPT, Cursor, Gemini, or VS Code with OAuth 2.1 + Outlook walkthrough.
- Connector Catalog & Setup
Enable SaaS connectors, SQL warehouses, and per-user vs org-shared credentials.
- MCP Tool Catalog
Exact tool names and schemas across /mcp, /analytics, /sandbox, /memory, and /delegate.
- MCP Federation
Wrap internal HTTP/SSE MCP servers in SSO, Guardian DLP, and audit logging.
- Service Connections API (/service)
Deterministic JSON-RPC 2.0 machine data plane for backend service-to-service tool calls.
Nunc Guardian
- Configure Guardian Firewall
Set Strict/Medium/Permissive presets, 17 PII detectors, custom regex, and egress allowlists.
- Tool Policies & Approvals (PBAC)
Configure User > Group > Org rules and human write-approval gates.
- Lock Claude MCP via MDM
Deploy managed-mcp.json and managed-settings.json on macOS, Windows, and Linux.
- Posture & ISO/IEC 42001 AIMS
Monitor endpoint drift, shadow MCP servers, and export SHA-256 audit evidence.
Private Agents & @nunc/sdk
- Configure Private Agents
Create domain agents in Console and invoke via /mcp/delegate or @nunc/sdk.
- TypeScript SDK (@nunc/sdk)
Embed tenant-scoped copilots and bind external customer claims for row-level SQL scoping.
- Workflows & Memory Tiers
Schedule multi-step runs and manage Public, Company, Workspace, and Agent memory.
Data Studio & Sidecar
- Warehouses & Table Scoping
Read-only SQL AST validation, Allow / Scope to User / Block rules, and Studio reports.
- Data Studio Web Guide
Build live SQL dashboards, 16:9 board decks, spreadsheets, and memos.
- Install Nunc Sidecar
Pair macOS and Windows workstations for local folder and CLI access.
Console & Operations
- Console Setup & RBAC
15-minute administrator runbook for SSO, groups, budgets, and emergency kill switches.
- Console Surface Map
Reference map of every screen under Overview, Build, Resources, Organization, and Trust.
- API Gating & Engine Reference
How Nunc isolates Console/Studio APIs, Service keys, Chat SDK keys, MCP, and Web Embeds.
Production endpoints & authentication
| Service | Endpoint URL | Auth | URL Filter Example |
|---|---|---|---|
| Tools MCP | https://api.nunc.cloud/mcp | OAuth 2.1 PKCE / Federated App Key | ?apps=outlook,salesforce |
| Analytics MCP | https://api.nunc.cloud/mcp/analytics | Human OAuth 2.1 PKCE | ?warehouse=prod_snowflake |
| Sandbox MCP | https://api.nunc.cloud/mcp/sandbox | Human OAuth 2.1 PKCE | Air-gapped Python / TS |
| Memory MCP | https://api.nunc.cloud/mcp/memory | Human OAuth 2.1 PKCE | ?workspace=finance-close |
| Delegate MCP | https://api.nunc.cloud/mcp/delegate | OAuth 2.1 PKCE / App Key | ?workspace=finance-close |
| Service API | https://api.nunc.cloud/service | Bearer nunc_* (type='service' App only) | JSON-RPC tools/list & tools/call |
Common issues & error codes
| Symptom / Status | Cause | Fix |
|---|---|---|
| 0 tools visible in client | Nunc 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_token | Expired 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_blocked | Tool, 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_required | Mutating 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_mismatch | SQL 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.