Integrations
An app, an automation or a team can act in the tools your company already uses. You declare which ones it needs. Claritty owns the sign-in and holds the credentials, so no key ever reaches your code.
How a connection is made
- 1Declare it. Add the integration to
intelligence.yaml. One line. - 2The user connects. Claritty renders a Connect button and runs the sign-in. You write no auth code and handle no callback.
- 3Your agent acts. Call the tool. The platform attaches that user’s credentials on the way out.
integrations:
- id: gmail
required: true
- id: slack
required: falseA required integration must be connected before the app will run. An optional one lets the app start without it and skip the steps that need it.
Two kinds of sign-in
37 services can be connected today. 14 of them support a full OAuth sign-in, where the user clicks Connect and nothing else. The rest ask for a token the service issues, which the user pastes once.
| Connect button | What the user does | |
|---|---|---|
| OAuth | 14 services | Clicks Connect, approves on the provider, comes back. No key changes hands. |
| Token | 23 services | Creates a token in the service and pastes it once. Stored encrypted, shown only by its last 4 characters afterwards. |
What you can connect
Work tracking
GitHub (OAuth), Jira (OAuth), Linear (OAuth), Asana (OAuth), GitLab, ClickUp, Trello, Notion (OAuth)
slack.post_message or gmail.send. An agent can only call tools whose integration the app declared. A call to an undeclared provider fails at load, not at run time.Connecting on behalf of your users
When you publish an app other people install, each of them connects their own accounts. Your app sees their data under their credentials, never yours, and never anyone else’s. You do not have to build the connect screen: the platform renders it from what your manifest declared.
Something not on the list
An app can call any HTTP API directly with a credential the user supplies, and an automation can read a web page it has been shown how to reach. A listed integration is the shortcut, not the boundary.