Skip to content

Agent connectors Beta

An agent connector makes tools and APIs from external services available to the AI agent.

You can create and manage them from global nav > Workspace settings > Agent Connectors.

Availability can also be restricted through Connector access in AI profiles.

INFO

This feature is in beta. The specification might change without notice.

Creating and managing

You need permission to change workspace settings to create, edit, or delete connectors.

  1. Open global nav > Workspace settings > Agent Connectors.
  2. Choose a built-in connector from the Catalog, which is shown by default.
    • Enter a service name in Search by service name... to find connectors.
    • You can filter by the following conditions:
      • Category (Collaboration / Sales & Marketing / Engineering / Data & Analytics / Operations)
      • Market (Global / Japan)
      • Authentication scope (Personal / Organization)
      • Connector type (MCP / API)
      • Status (Live-tested / Not live-tested / Upon request)
    • Filters start unselected and show every connector.
    • If you don't select a category, the catalog shows Popular connectors and then connectors grouped by category.
    • Each card shows its type and authentication scope.
    • Connectors that Codatum has tested show Live-tested with a check icon.
  3. Review its description, authentication methods, and official website in the catalog detail.
    • Each available authentication option is grouped in a separate panel.
    • Its values are paired with explicit labels such as Authentication method, Client registration, App setup, Credentials, and Authentication subject.
    • If the provider requires setup in advance, Required setup before connecting shows the instructions and any URL you need to register.
    • If the connector is available for self-service setup, select Add connector.
    • A connector marked Verification pending can't be added until live testing is complete.
    • To request access, select Contact us on its detail page.
    • If it's marked Upon request, also select Contact us on the detail page.
    • Confirm the connector and request type, enter optional details, then select Submit request.
    • For a destination not in the catalog, select Create custom connector to configure an MCP URL or API manually.
  4. If Required setup before connecting appears, complete those instructions. Enter the connector settings, then select Create. After creation, the My connectors tab opens.
  5. Use My connectors to view, edit, or delete created connectors.

Types

TypeDescription
MCPConnects to an MCP server and uses its published tools
APICalls an HTTP API directly

When creating a custom connector, you can choose MCP or API under Connector type. For built-in connectors, the type is already fixed.

Settings

Some items aren't shown, depending on the type and authentication method.

ItemDescription
NameThe connector's display name
Built-in connectorShown when created from a built-in connector (can't be changed)
OverviewA short description always passed to the agent. For API, you can set this from creation; for MCP, you set it when editing after creation
Skill docDetailed instructions loaded only when needed. Shown under the same conditions as Overview
Server URLThe MCP connection URL. Can't be changed after creation. Some built-in connectors ask for a data region, tenant, or other destination value to complete the URL
Auth scopeFor MCP: Workspace (API key) / Personal (OAuth) (when the built-in connector offers both). For API: Workspace / Personal
API key headerThe HTTP header name used for MCP API key authentication. It comes from the built-in connector and can't be changed
Endpoint prefixThe API base URL. Can't be changed after creation. Some built-in connectors ask for a store or other destination value to complete it
Secret keysThe key names and values used for API, or for MCP API key authentication. For MCP API key, enter the full header value in the format shown in the form
EnabledTurning this off disables the connector

For MCP OAuth, you can specify an OAuth client (client ID / client secret) and OAuth scopes under Advanced settings.

  • If the OAuth client is blank and the MCP server supports it, Dynamic Client Registration is used.
  • If OAuth scopes are blank, the scopes advertised by the server are requested.
  • If a built-in connector predefines OAuth scopes, the scopes field can't be left empty.

For built-in connectors that can't use Dynamic Client Registration, a workspace administrator creates an OAuth app with the provider and enters its client ID when a Codatum shared app isn't available. This applies to the following providers:

  • Google
  • Microsoft
  • GitHub
  • HubSpot
  • Salesforce
  • Box
  • Asana
  • Slack
  • PagerDuty
  • Gong
  • Front
  • Gainsight CS
  • Dropbox

The following providers also require a client secret:

  • Google
  • GitHub
  • HubSpot
  • Box
  • Asana
  • Slack
  • PagerDuty
  • Gong
  • Front
  • Gainsight CS

When a Codatum shared app is available, leave the OAuth client fields blank, or enter your own app credentials to override it.

For live-tested connectors that support your own app, the connector catalog details and creation form show the following:

  • The app creation page
  • App type
  • Required values
  • Official setup guide

Set the app's redirect URI (callback URL) to https://app.codatum.com/oauth/mcp/callback.

How credentials are handled depends on the type and authentication scope.

  • For MCP (OAuth), each user connects individually using personal authentication from the connector detail screen.
  • Credentials for MCP (API key) and API (workspace) are shared across the workspace.
  • Personal-scope API authentication is managed under Connector authentication in global nav > Workspace settings > Personal settings.

Built-in connectors

The following built-in connectors appear in the catalog. This list may be added to or changed without notice.

Connectors marked Upon request aren't currently available for self-service setup.

The detail page shows the verification status as Live-tested or Not live-tested.

  • Codatum has tested connectors marked Live-tested with a live service account.
  • Connectors marked Not live-tested are based on official specifications but can't be added until Codatum completes live testing. You can request access from the connector detail page.

Collaboration

NameTypeConnectionDescription
LinearAPIOrganization API key · Live-testedRetrieves issues, projects, teams, and more.
AirtableAPIOrganization API key · Live-testedRetrieves bases, tables, records, fields, and more.
NotionMCPPersonal OAuth · Live-testedConnects to workspace search, page operations, and content editing available to the authenticated user.
AtlassianMCPPersonal OAuth · Live-testedConnects to Jira issues and the Confluence knowledge base.
GmailMCPPersonal OAuth · Own app · Upon requestConnects to Gmail threads, drafts, and mail search.
Google CalendarMCPPersonal OAuth · Own app · Upon requestConnects to Google Calendar events and availability.
Google ChatMCPPersonal OAuth · Own app · Upon requestConnects to Google Chat spaces and messages.
Google DocsMCPPersonal OAuth · Own app · Upon requestConnects to Google Docs.
Google DriveMCPPersonal OAuth · Own app · Upon requestConnects to Google Drive files and Workspace documents.
Google SheetsMCPPersonal OAuth · Own app · Upon requestConnects to Google Sheets.
Google SlidesMCPPersonal OAuth · Own app · Upon requestConnects to Google Slides.
Microsoft Outlook CalendarMCPPersonal OAuth · Own app · Live-testedConnects to Outlook calendar.
Microsoft Outlook MailMCPPersonal OAuth · Own app · Live-testedConnects to Outlook mail.
Microsoft OneDriveMCPPersonal OAuth · Own app · Live-testedConnects to OneDrive files.
Microsoft SharePointMCPPersonal OAuth · Own app · Live-testedConnects to SharePoint sites, lists, and files.
Microsoft TeamsMCPPersonal OAuth · Own app · Live-testedConnects to Teams chats and channels.
Microsoft User DirectoryMCPPersonal OAuth · Own app · Live-testedConnects to Microsoft 365 user profiles and org structure.
Microsoft WordMCPPersonal OAuth · Own app · Live-testedConnects to Word documents.
SlackAPIOrganization API key · Live-testedOperates on channels, messages, users, and more.
WorkatoMCPPersonal OAuth · Live-testedConnects to recipe-derived tools and business automation context.
Composio ConnectMCPOrganization API key / Personal OAuth · Live-testedConnects to many apps through Composio Connect.
LinearMCPPersonal OAuth · Live-testedConnects to Linear issues and projects.
AirtableMCPPersonal OAuth · Live-testedConnects to Airtable bases and records.
AsanaMCPPersonal OAuth · Own app · Live-testedConnects to Asana tasks and projects.
BoxMCPPersonal OAuth · Own app · Live-testedConnects to Box files.
CanvaMCPPersonal OAuth · Upon requestConnects to Canva designs.
EgnyteMCPPersonal OAuth · Live-testedConnects to Egnyte files.
FirefliesMCPPersonal OAuth · Live-testedConnects to Fireflies transcripts.
MiroMCPPersonal OAuth · Live-testedConnects to Miro boards.
monday.comMCPPersonal OAuth · Live-testedConnects to monday.com boards.
GranolaMCPPersonal OAuth · Live-testedConnects to Granola meeting notes.
SlackMCPPersonal OAuth · Own app · Live-testedConnects to messages, channels, files, users, canvases, and lists. The shared app limits how often history and threads can be read.
ClickUpMCPPersonal OAuth · Live-testedConnects to tasks, lists, folders, documents, and chat.
DropboxMCPPersonal OAuth · Own app · Live-testedConnects to files, folders, search, sharing, and file requests.
ShortcutMCPPersonal OAuth · Live-testedConnects to stories, epics, and iterations.
kintoneAPIOrganization API key · Live-testedConnects to records and operational data in configured apps.
ChatworkAPIPersonal API token · Live-testedConnects to rooms, messages, members, and tasks.
BacklogAPIPersonal API token · Upon requestConnects to projects, issues, wikis, and users.
ANDPADAPIOrganization OAuth client · Upon requestConnects to construction and project data.
microCMSAPIOrganization API key · Upon requestConnects to content and schemas.
TimeRexAPIPersonal OAuth client · Upon requestConnects to scheduling data.

Sales & Marketing

NameTypeConnectionDescription
HubSpotAPIOrganization API key · Live-testedRetrieves CRM contacts, companies, deals, tickets, and more.
KARTEAPIOrganization API key · Live-testedReviews and edits KARTE campaigns, actions, and segments through KARTE API v2.
ShopifyAPIOrganization API key · Live-testedConnects to products, orders, customers, inventory, and more through Shopify Admin API.
IntercomMCPPersonal OAuth · Upon requestConnects to conversations, contacts, companies, and Help Center content.
SalesforceMCPPersonal OAuth · Own app · Live-testedConnects to Salesforce records and queries.
HubSpotMCPPersonal OAuth · Own app · Live-testedConnects to HubSpot CRM.
AttioMCPPersonal OAuth · Live-testedConnects to Attio CRM.
CloseMCPPersonal OAuth · Live-testedConnects to Close CRM.
SemrushMCPOrganization API key · Live-testedConnects to SEO, traffic, backlink, competitor, and project data.
AhrefsMCPPersonal OAuth / Organization API key · Live-testedConnects to SEO, keyword, backlink, and competitor research data.
ApolloMCPPersonal OAuth · Live-testedConnects to sales intelligence, prospects, and enrichment.
GongMCPPersonal OAuth · Own app · Not live-testedConnects to account, deal, contact, and revenue intelligence.
KlaviyoMCPPersonal OAuth · Live-testedConnects to profiles, campaigns, flows, segments, and delivery metrics.
BrazeMCPPersonal OAuth · Upon requestConnects to campaigns, Canvases, segments, analytics, and catalogs.
Customer.ioMCPPersonal OAuth · Live-testedConnects to profiles, campaigns, journeys, and delivery metrics.
FrontMCPPersonal OAuth · Own app · Not live-testedConnects to conversations, inboxes, contacts, messages, and drafts.
Gainsight CSMCPPersonal OAuth · Own app · Not live-testedConnects to companies, CTAs, Success Plans, Timeline, and scorecards.
WebflowMCPPersonal OAuth · Live-testedConnects to sites, pages, and CMS content.
WixMCPPersonal OAuth · Not live-testedConnects to sites, CRM, stores, and bookings.
SanityMCPPersonal OAuth · Live-testedConnects to content, datasets, and projects.
SansanAPIOrganization API key · Upon requestConnects to people, business card, tag, and organization data after Open API access is coordinated.
BASEAPIOrganization OAuth client · Upon requestConnects to shops, products, and orders after Direct API connectors support OAuth.
MiiTelMCPPersonal provider-managed authentication · Upon requestConnects to call and meeting analytics after provider coordination.
スマレジAPIOrganization OAuth client · Upon requestConnects to sales, product, customer, and inventory data.
Re:lationAPIOrganization API key · Upon requestConnects to inquiries, customers, and messages.
STORESAPIOrganization OAuth client · Upon requestConnects to commerce data.
SalesNowAPIOrganization API key · Upon requestConnects to company data.
Mazrica SalesAPIOrganization API key · Upon requestConnects to accounts, deals, and activities.
UpflowMCPPersonal OAuth · Upon requestConnects to sales conversations and customer insights.
amptalk analysisAPIOrganization API key · Upon requestConnects to call transcripts, summaries, and analytics.

Engineering

NameTypeConnectionDescription
DatadogMCPPersonal OAuth / Organization API key · Live-testedConnects to Datadog logs, metrics, traces, incidents, and more.
GitHubAPIOrganization API key · Live-testedRetrieves repositories, issues, pull requests, and more.
PagerDutyAPIOrganization API key · Not live-testedRetrieves incidents, services, on-call schedules, and more.
SentryMCPPersonal OAuth · Live-testedConnects to issues, projects, events, and more.
GitHubMCPPersonal OAuth · Own app · Live-testedConnects to GitHub repositories, issues, and pull requests.
VercelMCPPersonal OAuth · Upon requestConnects to Vercel projects and deployments.
BuildkiteMCPPersonal OAuth · Live-testedConnects to Buildkite pipelines and builds.
NetlifyMCPPersonal OAuth · Live-testedConnects to Netlify sites and deployments.
PulumiMCPPersonal OAuth · Live-testedConnects to Pulumi stacks.
GitLabMCPPersonal OAuth · Live-testedConnects to projects, issues, merge requests, pipelines, and repositories.
CloudflareMCPPersonal OAuth / Organization API key · Live-testedConnects to the Cloudflare API.
Grafana CloudMCPPersonal OAuth · Live-testedConnects to metrics, logs, dashboards, alerts, and incidents.
PagerDutyMCPPersonal OAuth · Own app / Organization API key · Not live-testedConnects to incidents, services, schedules, and on-call rotations.
HENNGE OneAPIOrganization client credentials · Upon requestConnects to identity and access data.

Data & Analytics

NameTypeConnectionDescription
dbt CloudMCPPersonal OAuth · Live-testedConnects to dbt Cloud's Semantic Layer, Discovery, and development context.
SupabaseMCPPersonal OAuth · Live-testedConnects to Supabase projects and schema.
NeonMCPPersonal OAuth · Live-testedConnects to Neon projects and branches.
ThoughtSpotMCPPersonal OAuth · Live-testedConnects to ThoughtSpot analytics.
MorningstarMCPPersonal OAuth · Not live-testedConnects to Morningstar financial data.
PostHogMCPPersonal OAuth / Organization API key · Live-testedConnects to product analytics, feature flags, experiments, and session recordings.
AmplitudeMCPPersonal OAuth · Live-testedConnects to analytics, taxonomy, experiments, cohorts, charts, and dashboards.
MixpanelMCPPersonal OAuth · Live-testedConnects to events, funnels, flows, retention, and product analytics.
Hugging FaceMCPPersonal OAuth · Live-testedConnects to models, datasets, Spaces, and papers on the Hugging Face Hub.
TROCCOAPIOrganization API key · Upon requestConnects to users, transfer jobs, data marts, and workflows.

Operations

NameTypeConnectionDescription
freeeMCPPersonal OAuth · Live-testedConnects to accounting, HR, invoicing, time tracking, and sales operations.
マネーフォワード クラウド会計MCPPersonal OAuth · Live-testedConnects to accounting data and operations.
StripeMCPPersonal OAuth · Live-testedConnects to customers, invoices, payments, and document operations.
PayPalMCPPersonal OAuth · Live-testedConnects to PayPal payments.
RampMCPPersonal OAuth · Upon requestConnects to Ramp expenses and cards.
PaddleMCPPersonal OAuth · Live-testedConnects to billing, subscriptions, and transactions.
SmartHRAPIOrganization API key · Live-testedConnects to employee and HR data.
ジョブカンAPIOrganization API key · Upon requestConnects to attendance and back-office data.
バクラクAPIOrganization API key · Upon requestConnects to requests, approvals, and expense data after Codatum validates the API integration.
カオナビAPIOrganization client credentials · Upon requestConnects to employee and talent data after client-credentials authentication is supported.
LegalOnAPIOrganization API key · Upon requestConnects to contract data.
KING OF TIMEAPIOrganization API key · Upon requestConnects to attendance, leave, and employee data.
Contract OneMCPPersonal provider-managed authentication · Upon requestConnects to contract data.