Skip to main content
Integrations enable Ona Agents to interact with external tools and services directly from your development environment. Built on the Model Context Protocol (MCP), integrations extend agent capabilities beyond code and command execution to include project management, documentation, design tools, and more. When enabled and authenticated, agents can read and write data in connected services, perform actions on your behalf (e.g., create issues, update documents), access context from external tools, and automate workflows across multiple platforms. All actions are performed with your explicit authorization and follow your organization’s security policies.

​
How integrations work

Integrations operate through a two-level configuration model:
  1. Organization-level enablement: Administrators enable integrations for the entire organization
  2. User-level authentication: Individual users authenticate to grant agents access to their accounts
This model ensures that:
  • Organizations control which integrations are available
  • Users maintain control over their personal accounts and data
  • Agents can only access services that both the organization and user have authorized

​
Available integrations

​
Linear

The Linear integration brings project management capabilities directly into Ona. Agents can:
  • Create and update issues: Generate issues from code comments, errors, or conversations
  • Search and filter: Find relevant issues based on status, assignee, labels, or content
  • Manage metadata: Add comments, update labels, change status, and assign issues
  • Access project context: Retrieve project information to inform development decisions
Example use cases:
  • “Create a Linear issue for this bug with steps to reproduce”
  • “Show me all high-priority issues assigned to me”
  • “Update issue ABC-123 to mark it as in progress”
  • “Add a comment to issue XYZ-456 with the fix details”

​
Configuring integrations

​
Organization setup

Organization administrators configure which integrations are available to team members. To enable integrations:
  1. Navigate to your organization settings
  2. Select the Integrations tab
  3. Enable the desired integrations
  4. Configure integration-specific settings (e.g., workspace URLs, default projects)
Organization integration configuration interface

Organization Integration Settings

Only organization administrators can enable or disable integrations. Contact your organization admin if you need access to a specific integration.

​
User authentication

Once an integration is enabled at the organization level, you must authenticate to grant agents access to your account. To authenticate an integration:
  1. Go to your user settings
  2. Navigate to the Integrations section
  3. Click Connect on the integration you want to use
  4. Follow the OAuth flow to authorize Ona
  5. Grant the requested permissions
User authentication interface for integrations

User Integration Authentication

Integrations can only access services after both organization enablement and user authentication are complete. If an agent cannot access an integration, verify both configuration levels.

​
Security and permissions

Integrations follow the principle of least privilege—agents can only access data you have permission to view, and all actions are performed with your user credentials.

​
Next steps