Connect Integrations
Integrations let your agent live where your users already are. openma ships three out of the box; each follows the same shape: install the app, grant scopes, publish an agent.
This page is for the hosted product. If you self-host, the OAuth apps are yours to register — see Self-host → OAuth Apps.
How integrations work
Section titled “How integrations work”For every connected workspace, the platform stores OAuth credentials in a Vault, listens to the platform’s webhooks, and exposes a set of MCP tools to the agent. When a triggering event happens (a Linear issue is assigned to your agent, a Slack @mention, a GitHub PR comment), the platform creates a new session and dispatches it.
Webhooks are signed by the platform; openma verifies them. Outbound calls back to the third-party use the OAuth token — never exposed to the model directly.
Connect Linear
Section titled “Connect Linear”- Integrations → Linear → Install.
- Authorize openma in the Linear OAuth screen (you must be a Linear workspace admin).
- Pick which agent serves this workspace.
- Choose capabilities: comment on issues, change status, create issues, etc.
The agent now appears as a workspace member in Linear. Mention it in a comment or assign an issue — both create a new session.
You need your own Linear OAuth app first. See Self-host → OAuth Apps → Linear.
Connect GitHub
Section titled “Connect GitHub”- Integrations → GitHub → Install.
- Pick the org or user account. Pick which repos the GitHub App can access.
- Pick which agent serves these repos.
- Grant capabilities: read PRs, comment on PRs, push branches, open PRs, etc.
The agent can now be triggered by PR comments or issue assignments.
You need your own GitHub App first. See Self-host → OAuth Apps → GitHub.
Connect Slack
Section titled “Connect Slack”- Integrations → Slack → Install.
- Pick the Slack workspace and the channels you want the agent to appear in.
- Pick which agent serves this workspace.
@mention the agent or DM it; both create sessions. Threaded replies stay in the same session.
You need your own Slack OAuth app. See Self-host → OAuth Apps → Slack.
Publication scopes
Section titled “Publication scopes”Each integration lets you scope what the agent can do. These are enforced at the API gateway, not just in the model’s prompt — even if the model decides to misbehave, scopes the publication didn’t grant simply aren’t exposed as tools.
| Integration | Common scopes |
|---|---|
| Linear | comment.create, issue.update, issue.create, issue.read |
| GitHub | pr.read, pr.comment, pr.create, branch.push, issue.read |
| Slack | chat.write, channels.history, files.upload |
Generic MCP
Section titled “Generic MCP”Beyond the three shipped integrations, any MCP-compatible server works. Add it on the Agent → MCP servers field; openma generates mcp_<server>_<tool> for each capability.