Skip to main content

​
What are connectors?

Connectors are authenticated links between Interact and external systems. There are two kinds:
  • Warehouse connectors — credentials for your data warehouse. Data Analyst agents query through the semantic models you allow on each agent.
  • Platform connectors (MCP) — a product’s MCP server, so agents can read live data and propose changes for approval.
Without at least one warehouse connector, agents cannot retrieve live warehouse data.

​
Getting started

1

Go to Settings → Connectors

In the left sidebar, navigate to Settings and click Connectors.
2

Click Add connector

Choose a warehouse or a platform (MCP) from the list.
3

Follow the setup guide

Each connector type has its own setup steps and credentials.
4

Attach it to an agent

For a warehouse: on the agent’s Data Access tab, set Warehouse connection and select semantic models. For MCP: attach the connector to the agent and enable the tools it may use.

​
Warehouses

Interact talks to your warehouse in a warehouse-agnostic way: each agent has a connection, queries go through semantic models, and credentials stay encrypted. Google BigQuery is the warehouse available today. Other warehouses are coming soon.

Google BigQuery

Connect your BigQuery project using a service account. Read-only access, dataset scope, and per-query data limits.

​
Platforms

MCP servers

Connect a platform’s MCP server so agents can read live data and propose changes for approval.

​
Managing connectors

From Settings → Connectors, you can view, edit, or delete connectors. Deleting a warehouse connector removes that connection from any agent that used it. A single warehouse connector can be shared across several agents, or you can create separate connectors (different credentials and IAM scopes) and assign them per agent.

​
Security

Warehouse credentials (for example a BigQuery service account JSON) are encrypted using Google Cloud KMS before they’re stored. They are decrypted only at query execution time and are never exposed to AI models.
Each agent uses one warehouse connection and only the semantic models you select for it. Raw SQL, when allowed, may only read those models’ source tables.
On a warehouse connector you can cap billable data volume per query. For BigQuery this is max billable MBs (default 1000 MB ≈ 1 GB). This is separate from Interact’s LLM cost caps.
Warehouse connectors are always read-only. Interact only runs SELECT queries — it never writes to, modifies, or deletes data in your warehouse.