Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.copass.com/llms.txt

Use this file to discover all available pages before exploring further.

An integration is an OAuth’d connection between your sandbox and a third-party app — Slack, GitHub, Notion, Gmail, HubSpot, Stripe, and 3,000+ more. Once connected, the app’s data flows in as a data source, and its capabilities show up as tools any agent in the sandbox can use. Copass uses Pipedream as the integration backend. Browse the full app catalog at pipedream.com/apps — every slug there is a slug you can connect.

​
What you can do

  • OAuth into a third-party app once; every agent in the sandbox can use it as a tool.
  • Browse the full app catalog with search and filters.
  • List, pause, or disconnect existing integrations at any time.
  • Register a custom data source for anything outside the catalog (your own MCP server, a folder of files, a CSV firehose).
“Connect my Slack workspace.” “What integrations do I have?” “Disconnect the GitHub integration on this sandbox.”
The Concierge handles the OAuth flow end-to-end — mints the Connect URL, opens it in your browser, watches for the webhook, and reports back when the connection is live.

​
Via the CLI

# Browse the catalog
copass integrations catalog --q crm

# OAuth a new connection (opens browser)
copass integrations connect slack

# List active connections
copass integrations list

# Disconnect
copass integrations disconnect <source_id>

​
Via the SDK

import open from 'open';

await router.integrations.connect('github', {
  onConnectUrl: (url) => open(url),
});
See the full SDK reference for list, disconnect, reconcile, and catalog.

​
Common patterns

One sandbox, many apps

Connect Slack, GitHub, Linear, and Notion to one sandbox. Every agent you build in that sandbox sees all four as tools automatically.

Per-end-user OAuth

In a multi-user app, each end user OAuths their own apps. The sandbox stays one tenancy; endUserId isolates whose connections are whose. See Multi-tenancy.

Custom data sources

Not in the Pipedream catalog? Register a custom data source and push to it directly. See Data Sources.

Bring your own MCP

You can plug your own MCP server in as a data source. The agent treats your MCP tools the same as any OAuth’d integration. See Custom MCP.

​
Next steps