Integrations & Connectivity

A comprehensive integration landscape: built-in connectors for enterprise systems, MCP extensibility for connecting any tool, embeddable widgets, and a full REST API.

Built-In Integrations

OpenRails ships with a rich set of built-in integrations that agents can use out of the box. These are production-ready connectors that require only configuration — no custom development needed.

Database

Direct SQL query access to relational databases. Agents can query data, describe schemas, and write results — with approval gates for sensitive operations.

Basecamp

Read-only access to Basecamp projects, message boards, messages, and search. Agents can retrieve project context, find discussions, and pull task information for analysis and reporting.

Azure DevOps

Connect to work items, sprints, teams, and time logging. Automate sprint reporting, track progress, log time entries, and pull development metrics for analysis.

EasyProjects

Time tracking and project/task management integration. Agents can retrieve project data, track time entries, and report on task progress and resource allocation.

Microsoft Teams

Bot-powered notifications and messaging. Agents can send alerts, post summaries, and deliver reports directly to Teams channels and conversations.

OneDrive / SharePoint

File and folder synchronization with document retrieval. Automatically ingest new files into the knowledge base as they appear, and access documents stored across Microsoft 365.

Web Search

Internet search capabilities that let agents find current information from across the web. Useful for research tasks, fact-checking, and gathering external context.

Web Crawler

Deep website crawling and content extraction. Configurable scope, depth limits, scheduled crawls, and intelligent content parsing that strips navigation and boilerplate.

Image Analysis

Vision and OCR analysis for images. Agents can extract text from scanned documents, analyze diagrams, read charts, and interpret visual content within workflows.

Site API

Configurable REST API integration for connecting to custom or internal APIs. Set up authentication, request mapping, and response parsing for any RESTful service.

Email (SMTP/IMAP)

Send notifications, process inbound emails, and extract attachments for document ingestion. Power automated email triage and response workflows.

MCP Extensibility — Connect Any Tool

OpenRails implements the Model Context Protocol (MCP), an open standard that lets you connect any external tool or service to your AI agents. MCP is how the platform stays extensible beyond the built-in integrations.

How it works: Any MCP-compatible tool server exposes a standard interface that describes its capabilities. Agents automatically discover available tools at runtime and invoke them with structured parameters. This means new integrations can be added without modifying agents — the agent simply discovers and uses whatever tools are available.

Dynamic Tool Discovery

Agents automatically enumerate available tools and their capabilities at runtime. No hardcoded integrations — add a new MCP server and agents can immediately use it.

Open Standard Protocol

MCP is a standards-based protocol, not a proprietary format. Any service that implements the MCP interface becomes a tool your agents can use.

Gateway with Security

OpenRails acts as an MCP gateway, routing tool calls with authentication, rate limiting, logging, and approval workflows for sensitive operations.

Bidirectional

OpenRails is both an MCP client (consuming external tools) and an MCP server (exposing its capabilities to external AI systems).

Headless API

Integrate OpenRails capabilities directly into your applications with API keys. The headless API provides full programmatic access to chat, agent execution, file uploads, and audio transcription — ideal for building custom integrations where connectors, MCP, or the embeddable widget are not the right fit.

Getting started: Generate an API key in the dashboard under Integrations > API > Keys, authenticate with the X-API-Key header, and consult the built-in API documentation page for available endpoints and best practices.

Connector Framework — Add New Integrations

The connector architecture is designed for expansion. Beyond the built-in integrations and MCP servers, OpenRails provides multiple pathways for adding new data sources and services:

Custom MCP Servers

Register any MCP-compliant tool server through the admin interface. Your agents can immediately discover and use the new tools — no platform changes required.

Custom Connectors

Need a connector that's not in the library yet? The Clarity team can rapidly build new connectors for your specific systems. Once added, they appear automatically in your connector menu — just add credentials and connect.

Webhook / API Triggers

RESTful API endpoints for external system triggers. Incoming webhooks can kick off agent workflows, playbooks, or data ingestion pipelines.

Enterprise Expansion

The architecture supports connecting to any enterprise system — Salesforce, SAP, Jira, Slack, HubSpot, and other platforms can be added through the connector framework or MCP.

Tip: If you need an integration that is not built in, the fastest path is often registering an MCP server. Any service that speaks MCP becomes instantly available to all your agents.

Widget Embedding

Embed OpenRails chat and agent interfaces directly into your internal portals, intranets, or customer-facing applications.

1. Configure the Widget

Select which agents, collections, and capabilities to expose. Set branding, colors, and allowed actions.

2. Generate Embed Code

OpenRails produces a lightweight JavaScript snippet that you add to your page. The widget handles authentication via token passthrough.

3. Deploy

Users interact with the AI assistant without leaving your application. All interactions are logged and governed by the same security policies.

Tip: Widgets respect the user's security level, so embedded chat will only return content the authenticated user is authorized to see.

API-First Architecture

Every capability in OpenRails is available through its REST API. The platform exposes a comprehensive set of API domains covering:

API Domain Key Endpoints
Agents CRUD operations, execution, status, run history
Chat Conversations, messages, streaming responses
Documents Upload, ingest, metadata, search
Collections Manage data lake collections and security levels
Connectors Configure and test external integrations
Evaluation Test suites, run evaluations, retrieve metrics
Administration Users, roles, security, system configuration