Configuring Connectors

Set up Basecamp and Azure DevOps connectors for project management integration

Overview

Connectors integrate OpenRails with external project management and development platforms. Each connector provides bi-directional access to resources, allowing agents to read and write data in external systems and enabling document sync into data lakes.

Available Connectors

Connector Capabilities Authentication
Basecamp Projects, message boards, to-dos, schedules, document sync OAuth 2.0
Azure DevOps Work items, sprints, time tracking, repositories, document sync Personal Access Token (PAT) or OAuth

Setting Up Basecamp

Navigate to Connectors

From the sidebar, click Connectors and then Add Connector.

Select Basecamp

Choose Basecamp from the connector type list.

Authenticate with OAuth

Click Connect with Basecamp to initiate the OAuth 2.0 flow. You will be redirected to Basecamp to authorize OpenRails access to your account.

Select Projects

After authentication, select which Basecamp projects OpenRails should have access to. You can add or remove projects later.

Configure Document Sync

Optionally enable document sync to automatically import Basecamp documents and message board content into a data lake.

Configure Routes

Set up route configuration to define which Basecamp resources (message boards, to-dos, etc.) map to specific agent tools.

Save

Click Save to finalize the Basecamp connector. Agents can now use Basecamp tools.

Setting Up Azure DevOps

Navigate to Connectors

From the sidebar, click Connectors and then Add Connector.

Select Azure DevOps

Choose Azure DevOps from the connector type list.

Enter Credentials

Provide your Azure DevOps organization URL and Personal Access Token (PAT). Ensure the PAT has the necessary scopes for work items, code, and build access.

Select Projects

Choose which Azure DevOps projects to connect. Each project's work items, repositories, and build pipelines become accessible.

Configure Time Tracking

Enable time tracking integration to allow agents to log time against work items directly from OpenRails.

Save

Click Save to finalize the Azure DevOps connector.

Tip: Use document sync to keep your data lakes current with project management content. This ensures RAG-enabled bots always have the latest project information.
Important: Connector credentials are stored with enterprise-grade encryption. However, the permissions granted via OAuth or PAT tokens determine what agents can access. Follow the principle of least privilege when creating tokens.

Next Steps