Overview
MCP Connectors let your team plug external data sources into Sight AI. Once connected, the agent can use provider tools in Agent chat and in custom automations — keyword research, SERP data, attribution metrics, CRM records, support conversations, and more. Open Integrations (app.trysight.ai/integrations) and filter by Connectors, or scroll to the Connectors section on the hub. Each card shows an MCP badge in the top-right corner.Connectors are team-scoped, not site-scoped. One connection per provider is shared across every site on your team. Automations still run against a single site’s data — connector tools supply external context.
Connectors are a Pro and Advanced feature. Starter plans don’t include MCP connectors — upgrade to Pro to connect external data sources. If a team downgrades, existing connections stay listed but become unavailable to the agent until the team is back on Pro or higher.
Available connectors
Sight AI ships prebuilt connectors for the providers below. Each uses the provider’s official connection method.SEO & web data
Analytics & attribution
Content & assets
CRM & revenue
Automation
Project & error tracking
How to connect
1
Open Integrations
Go to Integrations and select the Connectors category (or scroll to the Connectors section).
2
Choose a connector
Click the provider card you want to connect.
3
Authenticate
Follow the prompt on screen:
- Sign in (OAuth) — click Continue with [Provider] and approve access in your browser. You’ll return to Sight AI when done.
- API key / credentials — paste the key or credentials from your provider account, then click Connect.
- Cometly — enter your Space ID first, then complete the sign-in flow.
- Exa — click Connect; no key is required.
4
Review tools
After a successful connection, open the connector detail page to review available tools and set permissions.
Other ways to connect
- From Agent chat — click the + in the chat composer to search providers and connect one in-context, without leaving the conversation.
- During setup — the Setup hub’s Connectors card introduces connectors for new sites and links you to the Integrations hub.
Where to get API keys
Ahrefs
Ahrefs
In Ahrefs: Account Settings → API Keys → Generate MCP key. Requires an Ahrefs Lite plan or higher.Ahrefs MCP documentation →
Semrush
Semrush
In Semrush: Profile → Subscription info → API units — copy your API key.Semrush MCP documentation →
DataForSEO
DataForSEO
In DataForSEO: API Access — use your login and password together when prompted.DataForSEO MCP documentation →
SearchAPI
SearchAPI
In SearchAPI: Dashboard → API Key.SearchAPI documentation →
Firecrawl
Firecrawl
In Firecrawl: API Keys at firecrawl.dev.Firecrawl MCP documentation →
Apify
Apify
In Apify: Console → Settings → Integrations → API tokens.Apify MCP documentation →
Close
Close
In Close: Settings → API Keys.Close MCP documentation →
Zapier
Zapier
Create a Zapier MCP server at mcp.zapier.com, choose the actions to expose, and copy the API key.Zapier MCP documentation →
Cometly
Cometly
In Cometly: Space Settings → Space Details, or check the number at the bottom of the left navigation menu. Enter it in Sight AI before signing in.Cometly MCP documentation →
PostHog (EU cloud)
PostHog (EU cloud)
The prebuilt PostHog connector connects to the US cloud. If your PostHog project is on the EU cloud, add your EU endpoint as a custom connector instead.
Custom connectors
Add any supported HTTPS MCP server your team runs or subscribes to:- Integrations → Connectors → Add custom connector
- Provide a name, HTTPS MCP URL, and authentication:
- OAuth — browser sign-in (same flow as prebuilt OAuth connectors)
- API key — paste a key from your provider
- None — public MCP server only
- Save and wait for the connection to complete
Connector detail page
Click any connected connector card to open its detail page. From there you can:- Enable / disable the connector for your team
- Refresh tools — update the tool list from the provider
- Reconnect — re-authenticate after a key expires or access is revoked
- Disconnect — remove the connector and delete stored credentials
- Set per-tool permissions — control how each tool behaves in Agent chat
Connection health & disconnects
Sight AI monitors every connected connector automatically (about once an hour). If a connection breaks — an expired token, a revoked grant, or a provider outage — it’s handled for you:- Expired or revoked access is flagged immediately; other transient failures are flagged after a second consecutive failed check (to avoid noise from a momentary blip).
- Team owners and admins get an email identifying the connector that needs attention.
- Automations that depend on the broken connector are paused automatically (with a per-automation email) so scheduled runs don’t fail silently. They’re ready to re-enable once you reconnect.
- Reconnecting (Integrations → the connector → Reconnect) clears the alert, refreshes the tool list, and re-arms monitoring.
Tool permissions
Each tool on a connector has one of three permission levels:
Defaults:
- Always allow — read-only SEO and research connectors (Ahrefs, Semrush, DataForSEO, SearchAPI, Firecrawl, Exa, Parallel, Cometly)
- Ask first — connectors that can read or write live business data (CRM, billing, support, project tracking, automation platforms, Notion, PostHog, Apify, and all custom connectors)
Using connectors in Agent chat
When a connector is enabled and connected:- Tools are grouped by provider so they never collide with built-in Sight AI tools
- The agent attributes external data in replies (e.g. “per Ahrefs” or “per HubSpot”)
- Permission levels control whether each call needs confirmation
Connector tools are also available to the Slack agent, so your team can pull connector data straight from a Slack channel or DM.
- “What’s our domain rating and top referring domains per Ahrefs?”
- “Pull Semrush keyword volume for ‘ai visibility software’.”
- “Search Exa for recent articles about programmatic SEO.”
- “How many open deals do we have in HubSpot this quarter?”
Using connectors in Automations
Connector tools are available in the custom automation tool picker:- Create or edit a Custom automation
- In Allowed tools, expand the connector group (e.g. Ahrefs connector, HubSpot connector)
- Check the tools you want (tools set to Don’t allow are hidden)
- Write instructions that tell the automation when to call each tool
Free Domain Rating (no connector required)
Sight AI also uses Ahrefs’ free public Domain Rating API — no MCP key needed:- Your site’s DR is cached and injected into agent context automatically
- The built-in
getDomainRatingtool returns DR for your site or any competitor domain - Attribution: “Domain Rating by Ahrefs”
Limits
Tool names depend on what each provider exposes after connection. Use the connector detail page or the automations tool picker to see the live list for your team.
Who can manage connectors
Troubleshooting
Connector shows 'Needs attention' or error status
Connector shows 'Needs attention' or error status
Open the connector detail page and click Reconnect or Refresh tools. Common causes:
- API key connectors — invalid, expired, or revoked key; plan or quota limits on the provider side
- OAuth connectors — sign-in not completed; access revoked in the provider’s settings
- Cometly — incorrect Space ID
- Custom — server unavailable or authentication mismatch
Sign-in flow failed or timed out
Sign-in flow failed or timed out
Stay signed in to Sight AI through the entire provider sign-in flow. If the browser tab sat idle too long, restart the connect flow from Integrations.
Automation has 'no valid tools configured'
Automation has 'no valid tools configured'
The automation may reference connector tools that no longer exist (connector disconnected or tools refreshed). Re-edit the automation and re-select tools from the connector group in the picker.
Custom connector quota exceeded
Custom connector quota exceeded
Delete unused custom connectors before adding new ones. Maximum 5 custom connectors per team.
HubSpot connector vs HubSpot CMS
HubSpot connector vs HubSpot CMS
If you want to publish articles to HubSpot, use the HubSpot CMS integration. The HubSpot connector is for CRM and marketing data inside Agent chat and automations — not article publishing.
Related
- Custom automations — grant connector tools on scheduled workflows
- Automation tools reference — full built-in tool catalog
- HubSpot CMS integration — publish articles to HubSpot (separate from the HubSpot connector)
- Sight AI MCP (outbound) — connect Cursor or Claude Desktop to Sight AI (different from external connectors)