Bring your warehouses, databases, cloud storage, and the apps your team already uses into Summation.
Connectors are how your data reaches Summation. Connect a source once and its data stays current, so everything you build on top of it (chats, artifacts, scheduled workflows) reads live from the system your team already trusts.Connectors come in two kinds, on two tabs of the same page:
Data: warehouses, databases, object storage, and repositories. Pick which tables or files to bring in as datasets, and those datasets become available to Addison, artifacts, and your tables and data catalog.
Apps: third-party tools like Shopify, PostHog, or Tableau. Connecting one lets Addison work with that app directly in a chat.
The Connectors page: your data connections and their status
Terminology
Three terms get used throughout this section, and they’re easy to mix up.
Term
What it is
Example
Connector
A type of integration.
Snowflake, Postgres
Connection
A specific instance of a connector with credentials filled in.
Acme Corp’s prod warehouse
Dataset
One source object (table, view, file, or repo) pulled in through a connection.
analytics.public.orders
You can have multiple connections of the same connector type: one Snowflake connection for production and another for staging, for example.
Add a data connection
Click New connection (top-right of the Connectors page) to start a three-step wizard.
1
Choose a data source
Pick a connector type. Snowflake, Postgres, and BigQuery are surfaced under Popular; everything else is under Other, and app integrations appear under Apps.
Step 1: choose a data source
2
Enter connection details
Give the connection a Name and an optional Description. The name is the identifier used in SQL and the API, so it must start with a letter and contain only letters, numbers, hyphens, and underscores. Then fill in the connector’s own fields; View the setup guide links to that connector’s page below.You can also turn on Scheduled snapshots here. Datasets inherit the connection’s schedule unless they override or disable it.Click Test connection before continuing. A pass means Summation could authenticate and reach your data; a failure shows the message the source returned.
Step 2: connection details and credentials
3
Add datasets
Pick the tables, files, or repositories to expose. The browser is tailored to the connector: a database, schema, and table tree for warehouses, a file browser for object storage, a repo picker for GitHub. It has a tree on the left, search on the right, and a running count of what you’ve selected.Each selection becomes a dataset. Dataset names must be unique across your tenant, and the wizard suggests a unique name when there’s a conflict.
Step 3: pick the datasets to bring in
Manage a connection
Click any row on the Data tab to open its detail page.
Configuration & stored secrets: the non-secret fields (project, host, account) and which secrets are stored. Secret values are never shown after save; they render as ****.
Test connection: re-check credentials and reachability at any time.
Edit: update credentials when they rotate, or change configuration such as the warehouse, role, or region.
Disconnect: disconnect every dataset in this connection at once, leaving the definitions in place. Other connections aren’t affected, and you can reconnect later.
Delete: permanently remove the connection, its credentials, and all of its datasets.
A connection's detail page
Connection statuses. The colored dot on each connection shows its current state.
Status
Color
What it means
Active
Green
The connection is healthy and its datasets are queryable
Processing
Yellow
Datasets are deploying or syncing in the background
Error
Red
The last operation failed. Open the connection to see what went wrong
Disconnected
Grey
The connection is paused. Datasets stay defined but no queries run until you reconnect
Datasets and refresh
A connection’s Datasets tab lists everything it brings in: the dataset name, its source reference, when it refreshes, how the last refresh went, and the sync Strategy. Use + Add dataset to bring in more, the per-row refresh button to sync one now, and the Refresh history tab to see past runs across the connection.Sync strategies. How each refresh updates the stored copy.
Strategy
What it does
Full refresh
Replaces the dataset with a complete re-read of the source
Incremental (append)
Reads only new rows since the last run and appends them
Incremental (merge)
Reads only what changed and merges it into existing rows
Incremental (window)
Re-reads a moving time window and replaces just that slice
Incremental strategies need a column to track progress by, typically an updated-at timestamp or an increasing id.
Connect an app
The Apps tab lists app integrations grouped by category: AI, Analytics, Commerce, and more. Click + on an app to review what it does, then Connect. Most apps hand off to that provider’s sign-in to authorize access. Once connected, Addison can work with the app directly in a chat.
Available apps, by category
Review an app before connecting
Connected apps move to a Connected section at the top of the tab, where you can view the connector’s details or Disconnect it. If the app you need isn’t listed, Request an app tells us what to add, and a custom MCP server URL connects one we don’t list.
Third-party apps aren’t built or maintained by Summation, so review the permissions before connecting. Summation doesn’t train models on your connector content, and you can disconnect at any time.
Apps
Available apps by category, connecting one, and adding a custom app
Supported data sources
Each guide documents the fields that connector’s form asks for, where to find the values, and what the common errors mean.
Snowflake
Cloud data warehouse
BigQuery
Google Cloud data warehouse
Databricks
SQL Warehouse, Spark Connect, or Delta Lake
Postgres
PostgreSQL and compatible databases
Redshift
Amazon Redshift data warehouse
MySQL
MySQL and compatible databases
SQL Server
Microsoft SQL Server and compatible databases
ClickHouse
Columnar OLAP database
MongoDB
Document database collections
Oracle
Oracle Database, including Autonomous DB
MotherDuck
Hosted DuckDB
REST API
JSON APIs over HTTP
Datadog
Filtered logs, metric points, monitor inventory, and log aggregates
S3
AWS object storage (Parquet, CSV, JSON)
Apache Iceberg
Glue-backed or S3 warehouse lakehouse tables
AWS Glue
S3-backed Iceberg, Parquet, and CSV tables
GCS
Google Cloud Storage
Google Sheets
Worksheet tabs as refreshed tables
GitHub
Code repositories and issues
If you don’t see the source you need, tell us. Connectors are added regularly.
Troubleshooting
Test connection fails immediately. Double-check the host, the port, and that your network or firewall allows traffic from Summation’s egress IPs.
Test connection succeeds but datasets fail to load. This is usually a permissions problem on the source side. Check that the user or role you provided has read access to the schemas and tables you want.
Secrets seem to disappear after editing. Secret fields are write-only. They render blank after save, but the stored value is still there until you overwrite it.
Dataset name conflicts. Names must be unique across the tenant. Rename in the wizard before deploying.
A dataset shows a failed refresh. Open the connection’s Refresh history for the run’s error, then re-run that dataset with its row refresh button.
If a problem persists, copy the error from the Test connection result and contact support.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Summation","colors":{"primary":"#000000","light":"#888888","dark":"#000000"},"logo":{"light":"https://mintcdn.com/summation-676748f5/VNNtt3ifsblE4Ta9/images/summation-logo.svg?fit=max\u0026auto=format\u0026n=VNNtt3ifsblE4Ta9\u0026q=85\u0026s=6d050102e07df435f3532e1a4e34e685","dark":"https://mintcdn.com/summation-676748f5/VNNtt3ifsblE4Ta9/images/summation-logo.svg?fit=max\u0026auto=format\u0026n=VNNtt3ifsblE4Ta9\u0026q=85\u0026s=6d050102e07df435f3532e1a4e34e685"},"favicon":{"light":"https://mintcdn.com/summation-676748f5/shsHObvGm-SkiZl8/images/favicon.ico?fit=max\u0026auto=format\u0026n=shsHObvGm-SkiZl8\u0026q=85\u0026s=25d44d855522b83a4467f76687386368","dark":"https://mintcdn.com/summation-676748f5/shsHObvGm-SkiZl8/images/favicon.ico?fit=max\u0026auto=format\u0026n=shsHObvGm-SkiZl8\u0026q=85\u0026s=25d44d855522b83a4467f76687386368"},"appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"Get Started","href":"https://app.summation.com/signup"}},"fonts":{"family":"Inter"},"contextual":{"options":["copy","view","claude","chatgpt"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"summation-676748f5","hasAudioNarration":false,"actualSubdomain":"summation-676748f5","customDomains":["docs.summation.com"],"gitSource":{"type":"github","owner":"summationai","repo":"code","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5cda8b51d0e31167b5abb","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API","count":156},{"language":"default","tag":"Endpoints","count":144},{"language":"default","tag":"Documentation","count":49},{"language":"default","tag":"Tables","count":31},{"language":"default","tag":"Connectors","count":21},{"language":"default","tag":"Key concepts","count":20},{"language":"default","tag":"Data Connectors","count":17},{"language":"default","tag":"Grid","count":13},{"language":"default","tag":"Conversations","count":12},{"language":"default","tag":"Use cases","count":11}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"a[href=\"https://app.summation.com/signup\"]{border:0!important;box-shadow:none!important}a[href=\"https://app.summation.com/signup\"]>*{background:#000000!important;color:#ffffff!important;box-shadow:none!important;padding-right:1rem!important;padding-left:1rem!important;gap:0!important}a[href=\"https://app.summation.com/signup\"] span,a[href=\"https://app.summation.com/signup\"] svg{color:#ffffff!important}a[href=\"https://app.summation.com/signup\"] svg{display:none!important}a[href=\"https://app.summation.com/signup\"]:hover>*{background:#27272a!important}html[data-current-path=\"/home\"] .eyebrow{display:none}html[data-current-path^=\"/features/\"] .eyebrow{display:none}html[data-current-path=\"/home\"] #header{max-width:41rem;margin-top:3rem}html[data-current-path=\"/home\"] .mdx-content{margin-top:1.5rem}html[data-current-path=\"/home\"] #content-area{width:100%;max-width:64rem}html[data-current-path=\"/home\"] #header>p{margin-top:0.75rem;color:#52525b;font-size:1.125rem;line-height:1.75rem}.home-get-started{display:inline-flex;min-width:10rem;height:2.75rem;align-items:center;justify-content:center;gap:0.5rem;padding-inline:1rem;border-radius:0.75rem;background:#000000;box-shadow:none!important;color:#ffffff!important;font-size:0.875rem;font-weight:500;line-height:1;text-decoration:none!important;transition:background-color 120ms ease}.home-get-started:hover{background:#27272a;box-shadow:none!important}.home-get-started:focus-visible{outline:2px solid #000000;outline-offset:3px}.home-get-started img{width:1rem;height:1rem}.home-section-divider{width:100%;height:0.5px;margin-block:2.5rem;background:#e7e7e7}.home-section-divider+.card-group{margin-top:0!important}html[data-current-path=\"/home\"] .card-group{width:100%;max-width:64rem;grid-template-columns:repeat(3, minmax(0, 1fr))!important;justify-content:center;gap:1.5rem!important}html[data-current-path=\"/home\"] .card-group>.card{--primary: 228 228 231;display:flex;width:100%;min-height:9.5rem;padding:1.3125rem 1.5rem;align-items:center;box-sizing:border-box;margin-block:0!important;border:var(--border-width-border-half, 0.5px) solid\n var(--border-layout-divider, #e7e7e7)!important;border-radius:var(--border-radius-rounded-xl, 0.75rem);background:var(--color-neutral-white, #ffffff);box-shadow:0 1px 2px 0 rgb(0 0 0 / 5%);transition:background-color 120ms ease,\n box-shadow 120ms ease}html[data-current-path=\"/home\"] .card-group>.card:hover{background:#f4f4f5;border-color:#e4e4e7!important}html[data-current-path=\"/home\"] .card-group>.card>div{height:100%;width:100%;padding:0}html[data-current-path=\"/home\"] .card-group [data-component-part=\"card-title\"]{font-size:0.9375rem!important}html[data-current-path=\"/home\"] .card-group [data-component-part=\"card-content\"]{color:var(--home-card-description, #52525b)!important;font-size:0.875rem!important;line-height:1.25rem!important}html[data-current-path=\"/home\"] .card-group>.card svg{color:#000000!important}html.dark[data-current-path=\"/home\"] .card-group>.card{--primary-light: 63 63 70;--home-card-description: #888888;border-color:#3f3f46!important;background:#18181b}html.dark[data-current-path=\"/home\"] .card-group>.card svg{color:#f4f4f5!important}html.dark[data-current-path=\"/home\"] .card-group>.card:hover{background:#27272a;border-color:#3f3f46!important}html.dark[data-current-path=\"/home\"] .home-section-divider{background:#27272a}.card{background-color:#fafafa!important;transition:background-color 120ms ease,\n border-color 120ms ease}.card:hover{background-color:#f4f4f5!important}html.dark .card{background-color:#18181b!important}html.dark .card:hover{background-color:#232326!important}#content-area{box-sizing:content-box;width:auto;max-width:700px;margin-inline:auto}#page-title{font-size:2rem!important;line-height:2.5rem!important}#page-context-menu-button{border-radius:8px 0 0 8px!important}#page-context-menu>button[aria-label=\"More actions\"]{border-radius:0 8px 8px 0!important}html[data-current-path=\"/home\"] #page-context-menu{display:none!important}div[role=\"menu\"]:has([role=\"menuitem\"] [class~=\"wrap-break-word\"]) [role=\"menuitem\"]>div:first-child{border-color:transparent!important}div[role=\"menu\"]:has([role=\"menuitem\"] [class~=\"wrap-break-word\"]) [role=\"menuitem\"]>div:nth-child(2)>div:first-child>svg{display:none!important}.mdx-content{font-size:15px;letter-spacing:-0.1px}.mdx-content a.link{border-bottom:0;font-weight:400;text-decoration-line:underline;text-decoration-style:dotted;text-decoration-color:#a1a1aa;text-decoration-thickness:from-font;text-decoration-skip-ink:none;text-underline-position:from-font;transition:text-decoration-color 120ms ease-out}.mdx-content a.link:hover{text-decoration-style:solid;text-decoration-color:currentColor}@media (prefers-reduced-motion: reduce){.mdx-content a.link{transition:none}}.mdx-content>h2{margin-top:3rem!important}#table-of-contents-content{--toc-indicator-height: 1.5rem;--toc-indicator-y: 0px;position:relative;border-left:1px solid #e4e4e7}nav:has(>div>#table-of-contents-content)>h2{display:none}#table-of-contents-content::before{position:absolute;top:0;left:-2px;width:3px;height:var(--toc-indicator-height);border-radius:0;background:#27272a;content:\"\";opacity:0;pointer-events:none;transform:translateY(var(--toc-indicator-y));transition:transform 240ms cubic-bezier(0.4, 0, 0.2, 1),\n height 240ms cubic-bezier(0.4, 0, 0.2, 1),\n opacity 120ms ease-out}#table-of-contents-content[data-has-active=\"true\"]::before{opacity:1}@media (prefers-reduced-motion: reduce){#table-of-contents-content::before{transition:opacity 120ms ease-out}}#table-of-contents-content .toc-item>a{padding-left:calc(\n var(--toc-padding-left) + var(--toc-focus-padding, 0rem) + 1rem\n )!important}#table-of-contents-content .toc-item[data-active=\"true\"]>a{font-weight:400;text-shadow:none!important}#table-of-contents-content .toc-item[data-active=\"true\"]:not([data-toc-current=\"true\"])>a{color:#4f4f4f}#table-of-contents-content .toc-item[data-toc-current=\"true\"]>a{color:#000000}.dark #table-of-contents-content{border-left-color:#3f3f46}.dark #table-of-contents-content .toc-item[data-active=\"true\"]:not([data-toc-current=\"true\"])>a{color:#9e9e9e}.dark #table-of-contents-content .toc-item[data-toc-current=\"true\"]>a{color:#888888}.dark #table-of-contents-content::before{background:#f4f4f5}#navigation-items .sidebar-group>li+li{margin-top:4px}#navigation-items .sidebar-group a,#navigation-items .sidebar-group button[aria-expanded]{width:calc(100% - 0.5rem)!important;margin-left:0.5rem}#navigation-items .sidebar-group a,#navigation-items .sidebar-group button[aria-expanded]{padding-top:0.25rem!important;padding-bottom:0.25rem!important;line-height:1.25rem!important}#sidebar a[aria-current=\"page\"]{background-color:#f4f4f5!important;border-radius:8px!important;color:#000000!important;font-weight:500!important;text-shadow:none!important}#navigation-items a:not([aria-current=\"page\"]):hover{background-color:#fafafa!important}.dark #navigation-items a:not([aria-current=\"page\"]):hover{background-color:#18181b!important}.dark #sidebar a[aria-current=\"page\"]{background-color:#27272a!important;color:#ffffff!important}#sidebar button[aria-expanded]>div:last-child{margin-left:auto}#navigation-items .sidebar-group a span,#navigation-items .sidebar-group button span{hyphens:none}div:has(>form #search-input){padding:0!important;border:0!important;background:transparent!important;box-shadow:none!important}#theme-preference-menu-trigger{width:2.25rem;height:2.25rem;padding:0!important;border:0.5px solid #e4e4e7;border-radius:0.625rem!important}#theme-preference-menu-trigger [data-theme-preference-icon]{display:none!important}#theme-preference-menu-trigger [data-theme-preference-icon=\"dark\"]{display:inline-flex!important}html[data-summation-theme-toggle=\"ready\"] #theme-preference-menu-content{display:none!important}.dark #theme-preference-menu-trigger{border-color:#27272a}.dark #theme-preference-menu-trigger [data-theme-preference-icon=\"dark\"]{display:none!important}.dark #theme-preference-menu-trigger [data-theme-preference-icon=\"light\"]{display:inline-flex!important}#header-ask-ai,#assistant-entry{display:none!important}.chat-assistant-floating-input{display:none!important}#pagination{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));gap:1.5rem;padding:0}#footer{border-top:0!important}html[data-current-path=\"/home\"] #pagination{display:none!important}#pagination>a{display:grid;box-sizing:border-box;min-width:0;height:5rem;align-content:center;padding:1rem 1.5rem;column-gap:0.75rem;row-gap:0.5rem;border:1px solid #e4e4e7;border-radius:0.75rem;background:transparent;font-weight:400;transition:border-color 120ms ease,\n background-color 120ms ease}#pagination>a:hover{border-color:#d4d4d8;background:#fafafa}#pagination>a::before{color:#71717a;font-size:0.8125rem;font-weight:400;line-height:1.25rem}#pagination .pagination-prev{grid-template-columns:auto minmax(0, 1fr)}#pagination .pagination-prev::before{grid-column:2;grid-row:1;content:\"Previous\"}#pagination .pagination-next{grid-template-columns:minmax(0, 1fr) auto;margin-left:0;text-align:right}#pagination .pagination-next::before{grid-column:1;grid-row:1;content:\"Next\"}#pagination [data-component-part=\"pagination-chevron\"]{grid-row:1;width:0.25rem;height:0.5rem;align-self:center;stroke-width:1}#pagination [data-component-part=\"pagination-chevron\"] path{stroke-width:1!important}#pagination [data-component-part=\"pagination-title\"]{grid-column:1 / -1;grid-row:2;color:#27272a;font-size:0.9375rem;font-weight:400;line-height:1.5rem}.dark #pagination>a{border-color:#3f3f46}.dark #pagination>a:hover{border-color:#52525b;background:#18181b}.dark #pagination [data-component-part=\"pagination-title\"]{color:#f4f4f5}header .max-w-8xl{max-width:none!important;margin-inline:0!important}#navbar a[href=\"/\"]:has(.nav-logo){display:flex;align-items:center}#navbar a[href=\"/\"] .nav-logo{height:1.25rem!important}.dark #navbar a[href=\"/\"] .nav-logo{filter:invert(1)}#navbar .max-w-8xl>div>div>.flex.items-center{padding-inline:1.5rem!important}@media (max-width: 639px){#navbar a[href=\"/\"] .nav-logo{height:1.125rem!important}}#navbar>div:first-child{border-bottom-color:#f0f0f0!important}:root{--topbar-tabs-height: 0rem !important}@media (min-width: 1024px){#navbar div.hidden.lg\\:flex.px-12.h-12{position:absolute!important;top:0!important;left:183px!important;height:4rem!important;padding:0!important;width:auto!important}#navbar .nav-tabs{column-gap:2rem}#navbar .nav-tabs-item{gap:0.5rem;white-space:nowrap}#navbar .nav-tabs-item:hover>div.absolute.bottom-0{background-color:currentColor}#navbar .nav-tabs-item[aria-current=\"location\"]>div.absolute.bottom-0{background-color:#27272a!important}.dark #navbar .nav-tabs-item[aria-current=\"location\"]>div.absolute.bottom-0{background-color:#888888!important}#navbar .nav-tabs-item[aria-current=\"location\"]{text-shadow:none!important}}@media (min-width: 1024px){#navbar div:has(>#search-bar-entry){flex:0 1 16rem;min-width:12rem}#navbar div:has(>nav[aria-label=\"Main\"]){flex:0 0 auto;margin-left:0}}#search-bar-entry:focus-visible{outline:2px solid currentColor;outline-offset:2px}.sidebar-group-header--collapsible{cursor:pointer;user-select:none}.sidebar-group-header--collapsible:hover{color:#18181b}.dark .sidebar-group-header--collapsible:hover{color:#f4f4f5}.sidebar-group-header--collapsible:focus-visible{outline:2px solid #a1a1aa;outline-offset:2px;border-radius:4px}.sidebar-group-chevron{margin-left:auto;transform:rotate(90deg);transition:transform 120ms ease}.sidebar-group-header--collapsible[data-sidebar-collapsed=\"true\"] .sidebar-group-chevron{transform:rotate(0deg)}ul.sidebar-group[data-sidebar-collapsed=\"true\"]{display:none}header div:has(>#theme-preference-menu-trigger){margin-left:0.5rem!important}#navbar nav:has(a[href=\"https://app.summation.com/signup\"]){margin-right:0!important}header a[href=\"https://app.summation.com/signup\"]{padding-inline:0.75rem!important}header a[href=\"https://app.summation.com/signup\"]>div{padding-inline:0!important;background:#000000!important}@media (min-width: 1024px){html[data-current-path=\"/home\"] #content-container{position:relative;left:7.5rem}#sidebar{width:280px!important;max-width:280px;transform:translateX(min(-2rem, calc((92rem - 100vw) / 2 - 2rem)));border-right:1px solid #f0f0f0}html:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #sidebar{transform:translateX(min(-2rem, calc((115rem - 100vw) / 2 - 2rem)))}#sidebar>#sidebar-content{top:0!important;left:1.5rem!important}#sidebar-content>[class~=\"pr-8\"]{padding-right:1.5rem!important}#sidebar-content .sticky.top-0.h-8{height:1.5rem}#sidebar-content>[data-component-part=\"scroll-area-scrollbar\"][data-orientation=\"vertical\"]{inset-inline-end:-2.5px!important;margin-inline:0!important}.dark #sidebar{border-right-color:rgba(255, 255, 255, 0.18)}}@media (min-width: 1280px){html[data-current-path=\"/home\"] #header,html[data-current-path=\"/home\"] .mdx-content{transform:translateX(-1.625rem)}html[data-current-path=\"/home\"] .mdx-content{width:calc(100% + 5.25rem)}}@media (min-width: 1024px) and (max-width: 1599px){html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #content-container{left:0}}@media (min-width: 1280px) and (max-width: 1599px){html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #header,html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) .mdx-content{transform:none}html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) .mdx-content{width:100%}}@media (min-width: 1600px) and (max-width: 1839px){html[data-current-path=\"/home\"]:has(#chat-assistant-sheet[aria-hidden=\"false\"]) #content-container{left:calc(50vw - 50rem)}}@media (max-width: 767px){#pagination{grid-template-columns:minmax(0, 1fr)}html[data-current-path=\"/home\"] #header{margin-top:2rem}html[data-current-path=\"/home\"] #header>p{font-size:1rem;line-height:1.5rem}.home-section-divider{margin-block:1.5rem}html[data-current-path=\"/home\"] .card-group{grid-template-columns:minmax(0, 1fr)!important}}figure[data-name=\"frame\"]{padding:1.25rem!important;margin-top:0!important;margin-bottom:1.5rem!important;border-radius:var(--border-radius-rounded-xl, 0.75rem)!important;background:#fafafa!important}.columns figure[data-name=\"frame\"]{margin-bottom:0!important}.columns{margin-top:0!important;margin-bottom:1.5rem!important;row-gap:1.5rem!important}html.dark figure[data-name=\"frame\"]{background:#18181b!important}figure[data-name=\"frame\"]>div[class*=\"bg-grid\"]{display:none}figure[data-name=\"frame\"]>div[class*=\"justify-center\"]{overflow:visible;border-radius:0}figure[data-name=\"frame\"] img{border-radius:0.375rem;box-shadow:0 0 0 0.5px #d4d4d8,\n 0 1px 2px 0 rgb(0 0 0 / 5%)}html.dark figure[data-name=\"frame\"] img{box-shadow:0 0 0 0.5px #3f3f46,\n 0 1px 2px 0 rgb(0 0 0 / 30%)}figure[data-name=\"frame\"]>div[class*=\"pointer-events-none\"]{border-color:transparent}@media (max-width: 767px){figure[data-name=\"frame\"]{padding:0.75rem!important}}html[data-current-path=\"/introduction\"] .card-group,html[data-current-path=\"/use-cases/overview\"] .card-group:has(>.card [data-component-part=\"card-content-container\"].items-center){row-gap:0.5rem!important}html[data-current-path=\"/introduction\"] .card-group>.card,html[data-current-path=\"/use-cases/overview\"] .card-group:has(>.card [data-component-part=\"card-content-container\"].items-center)>.card{margin-block:0!important}.template-meta{display:grid;grid-template-columns:7.5rem minmax(0, 1fr);gap:0.5rem 1rem;margin:0 0 1.5rem;padding:1.25rem;border-radius:var(--border-radius-rounded-xl, 0.75rem);background:#fafafa}.template-meta-label{margin:0;font-weight:500;color:#71717a}.template-meta-value{margin:0}html.dark .template-meta{background:#18181b}html.dark .template-meta-label{color:#a1a1aa}@media (max-width: 639px){.template-meta{grid-template-columns:minmax(0, 1fr);gap:0.25rem;padding:1rem}.template-meta-value:not(:last-child){margin-bottom:0.5rem}}"}],"page":{"pagePath":"features/connectors","slug":"/features/connectors","pageMetadata":{"title":"Connectors","sidebarTitle":"Overview","description":"Bring your warehouses, databases, cloud storage, and the apps your team already uses into Summation.","href":"/features/connectors"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Bring your warehouses, databases, cloud storage, and the apps your team already uses into Summation.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,Columns,Frame,Heading,Note,OptimizedImage,Step,Steps,Table,Visibility,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Visibility)_missingMdxReference(`Visibility`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Connectors are how your data reaches Summation. Connect a source once and its data stays current, so everything you build on top of it (chats, artifacts, scheduled workflows) reads live from the system your team already trusts.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Connectors`}),` come in two kinds, on two tabs of the same page:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Data`}),`: warehouses, databases, object storage, and repositories. Pick which tables or files to bring in as `,_jsx(_components.strong,{children:`datasets`}),`, and those datasets become available to `,_jsx(_components.a,{href:`/features/addison`,children:`Addison`}),`, `,_jsx(_components.a,{href:`/features/artifacts`,children:`artifacts`}),`, and your `,_jsx(_components.a,{href:`/features/tables`,children:`tables and data catalog`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Apps`}),`: third-party tools like Shopify, PostHog, or Tableau. Connecting one lets Addison work with that app directly in a chat.`]}),`\n`]}),`\n`,_jsx(Frame,{caption:`The Connectors page: your data connections and their status`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=d885c7de2fa4f52eaf72df7aa5123e75`,alt:`The Connectors page titled 'Connectors — Create and manage data connections and app integrations', with a New connection button in the top-right and Data / Apps tabs below. A table lists connections by Name and Status, each with its source type beneath the name: bq_test (BigQuery), DEMO_WH (Snowflake), shortify-url (GitHub), Salesforce connection fresh (Salesforce), Shopify connection (Shopify), and NetSuite connection (NetSuite), each with a 'Last updated' date and a status dot.`,\"data-og-width\":`2036`,width:`2036`,\"data-og-height\":`1566`,height:`1566`,\"data-path\":`images/features/connectors/connectors-home.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=ff1fb9f2364f3d6b9161906ec1dfad27 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=48c33be705c67497a33c08ef0782c1a3 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=da47b67842e3c3d733bd15d31a09e27a 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=2e44eeca3b7fde43536284bb082343bc 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=c90d238cddf785dba414b8925bd0d438 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connectors-home.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=d38959e147190d62cd0607a12ca2f0ef 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`terminology`,children:`Terminology`}),`\n`,_jsx(_components.p,{children:`Three terms get used throughout this section, and they’re easy to mix up.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Term`}),_jsx(_components.th,{children:`What it is`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Connector`})}),_jsx(_components.td,{children:`A type of integration.`}),_jsxs(_components.td,{children:[_jsx(_components.em,{children:`Snowflake`}),`, `,_jsx(_components.em,{children:`Postgres`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Connection`})}),_jsx(_components.td,{children:`A specific instance of a connector with credentials filled in.`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`Acme Corp’s prod warehouse`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Dataset`})}),_jsx(_components.td,{children:`One source object (table, view, file, or repo) pulled in through a connection.`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`analytics.public.orders`})})]})]})]}),`\n`,_jsx(_components.p,{children:`You can have multiple connections of the same connector type: one Snowflake connection for production and another for staging, for example.`}),`\n`,_jsxs(Visibility,{for:`agents`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Where each action lives in the UI`}),` (for telling users where to click):`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connectors home`}),`: the `,_jsx(_components.strong,{children:`Connectors`}),` entry in the left nav sidebar (`,_jsx(_components.code,{children:`/connectors`}),`). It has a `,_jsx(_components.strong,{children:`Data`}),` / `,_jsx(_components.strong,{children:`Apps`}),` segmented control and a `,_jsx(_components.strong,{children:`New connection`}),` button at the top-right. The Data tab is a table of connections (Name + description, last-updated date, status dot); the Apps tab lists `,_jsx(_components.strong,{children:`Connected`}),` apps and `,_jsx(_components.strong,{children:`Available apps`}),` grouped by category, with its own `,_jsx(_components.strong,{children:`Search`}),` field.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`New connection wizard`}),`: three steps. `,_jsx(_components.strong,{children:`1/3 Choose a data source`}),` (Popular / Other / Apps), `,_jsx(_components.strong,{children:`2/3 Connection details`}),` (name, description, connector fields, `,_jsx(_components.strong,{children:`Scheduled snapshots`}),`, `,_jsx(_components.strong,{children:`Test connection`}),`), `,_jsx(_components.strong,{children:`3/3`}),` dataset selection. `,_jsx(_components.strong,{children:`Back`}),` and `,_jsx(_components.strong,{children:`Continue`}),` move between steps; `,_jsx(_components.strong,{children:`Test connection`}),` must pass before continuing.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connection detail page`}),`: click a row on the Data tab. The header has a rename pencil, `,_jsx(_components.strong,{children:`Test connection`}),`, `,_jsx(_components.strong,{children:`Edit`}),`, and a `,_jsx(_components.strong,{children:`⋮`}),` menu (Disconnect / Delete). Below it, a collapsible `,_jsx(_components.strong,{children:`Configuration \u0026 stored secrets`}),` panel (secret values render as `,_jsx(_components.code,{children:`****`}),`), then `,_jsx(_components.strong,{children:`Datasets`}),` / `,_jsx(_components.strong,{children:`Refresh history`}),` tabs with `,_jsx(_components.strong,{children:`Select`}),` and `,_jsx(_components.strong,{children:`+ Add dataset`}),`. Each dataset row shows its refresh schedule, last-run result, and sync `,_jsx(_components.strong,{children:`Strategy`}),`, with a per-row refresh button and `,_jsx(_components.strong,{children:`⋮`}),` menu.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Connect an app`}),`: `,_jsx(_components.strong,{children:`Apps`}),` tab → `,_jsx(_components.strong,{children:`+`}),` on an app card → a review dialog → `,_jsx(_components.strong,{children:`Connect`}),` (usually an OAuth hand-off). Connected apps get `,_jsx(_components.strong,{children:`View Connector Details`}),` and `,_jsx(_components.strong,{children:`Disconnect`}),`. There’s also `,_jsx(_components.strong,{children:`Request an app`}),` for apps not in the catalog, and a direct `,_jsx(_components.strong,{children:`MCP server URL`}),` option for custom servers.`]}),`\n`,_jsxs(_components.li,{children:[`Connection statuses are `,_jsx(_components.code,{children:`ACTIVE`}),`, `,_jsx(_components.code,{children:`DEPLOYING`}),` (shown as `,_jsx(_components.em,{children:`Processing`}),`), `,_jsx(_components.code,{children:`ERROR`}),`, and `,_jsx(_components.code,{children:`DISCONNECTED`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Dataset sync strategies: `,_jsx(_components.code,{children:`FULL_REFRESH`}),`, `,_jsx(_components.code,{children:`INCREMENTAL_APPEND`}),`, `,_jsx(_components.code,{children:`INCREMENTAL_APPEND_DEDUPED`}),`, `,_jsx(_components.code,{children:`INCREMENTAL_WINDOWED`}),`, surfaced as `,_jsx(_components.em,{children:`Full refresh`}),`, `,_jsx(_components.em,{children:`Incremental (append)`}),`, `,_jsx(_components.em,{children:`Incremental (merge)`}),`, and `,_jsx(_components.em,{children:`Incremental (window)`}),`.`]}),`\n`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`/connectors`}),` (and its nav entry) redirects away two independent ways: where\nconnectors are not enabled for the workspace, and where the tenant has no\nfederated query engine deployment provisioned. The `,_jsx(_components.strong,{children:`Data`}),` / `,_jsx(_components.strong,{children:`Apps`}),`\nsegmented control is enabled separately; without it there’s no Apps tab,\njust a single untabbed connectors page.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`add-a-data-connection`,children:`Add a data connection`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`New connection`}),` (top-right of the `,_jsx(_components.strong,{children:`Connectors`}),` page) to start a three-step wizard.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Choose a data source`,children:[_jsxs(_components.p,{children:[`Pick a connector type. `,_jsx(_components.strong,{children:`Snowflake`}),`, `,_jsx(_components.strong,{children:`Postgres`}),`, and `,_jsx(_components.strong,{children:`BigQuery`}),` are surfaced under `,_jsx(_components.strong,{children:`Popular`}),`; everything else is under `,_jsx(_components.strong,{children:`Other`}),`, and app integrations appear under `,_jsx(_components.strong,{children:`Apps`}),`.`]}),_jsx(Frame,{caption:`Step 1: choose a data source`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=b4b4348cae7c16923a887a332071fbef`,alt:`Step 1 of 3 of the New connection wizard, titled 'Choose a data source' with a progress indicator reading 1/3. A Popular row offers Snowflake (Data warehouse), Postgres (Database), and BigQuery (Data warehouse). An Other section lists S3 (File storage), GitHub (Repository), Databricks (Lakehouse), ClickHouse, MySQL, Oracle, MotherDuck, Redshift, GCS, SQL Server, REST API (HTTP endpoint), MongoDB (Document database), and Apache Iceberg (Lakehouse catalog). An Apps section below starts with Shopify, NetSuite, and Salesforce.`,\"data-og-width\":`1324`,width:`1324`,\"data-og-height\":`1624`,height:`1624`,\"data-path\":`images/features/connectors/wizard-choose-source.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=16622f402a86343a2a161e9ed7119fbf 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=17b3a6ea7fa2be81385a7e1d0d8b9cbc 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=52fe14f59775dda2543dff31eae2ca87 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=e90b600af900fa164e015cd30d6d8626 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=aed44ea30c6369456ab8a2c038aa1583 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-choose-source.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=e82e96180e6ecfc87f6d77b3e2aea00b 2500w`})})]}),_jsxs(Step,{title:`Enter connection details`,children:[_jsxs(_components.p,{children:[`Give the connection a `,_jsx(_components.strong,{children:`Name`}),` and an optional `,_jsx(_components.strong,{children:`Description`}),`. The name is the identifier used in SQL and the API, so it must start with a letter and contain only letters, numbers, hyphens, and underscores. Then fill in the connector’s own fields; `,_jsx(_components.strong,{children:`View the setup guide`}),` links to that connector’s page below.`]}),_jsxs(_components.p,{children:[`You can also turn on `,_jsx(_components.strong,{children:`Scheduled snapshots`}),` here. Datasets inherit the connection’s schedule unless they override or disable it.`]}),_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Test connection`}),` before continuing. A pass means Summation could authenticate and reach your data; a failure shows the message the source returned.`]}),_jsx(Frame,{caption:`Step 2: connection details and credentials`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=2876b6e9531b13f9b2564173c872eb92`,alt:`Step 2 of 3 of the wizard, titled 'Connection details' (2/3). It has Name and optional Description fields, a 'Need help setting this up? View the setup guide' link, and a Snowflake section with an Authentication toggle between Password and Key pair, plus Account Identifier (myorg-myaccount), Warehouse (COMPUTE_WH), optional Role (ACCOUNTADMIN), Username, and Password fields. Below is a 'Scheduled snapshots' row with an Enabled checkbox and the note 'Datasets inherit this schedule unless they override or disable it.', and Test connection, Back, and Continue buttons with the hint 'Test your connection before continuing.'`,\"data-og-width\":`1324`,width:`1324`,\"data-og-height\":`1810`,height:`1810`,\"data-path\":`images/features/connectors/wizard-connection-details.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=e872fc4038a70a0758a612465f5b6d5a 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=c536cf6d142cd59a5136b8f2a69e1a8f 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=e365e99717b7d9e35cd3aae7a8d2a458 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=69a8e21f12a01a2d0a842caecf27ac06 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=64889e84416e4fc6ef5387ea4e63ae24 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-connection-details.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=396ba23288b775710d0b3bd8296ad566 2500w`})})]}),_jsxs(Step,{title:`Add datasets`,children:[_jsx(_components.p,{children:`Pick the tables, files, or repositories to expose. The browser is tailored to the connector: a database, schema, and table tree for warehouses, a file browser for object storage, a repo picker for GitHub. It has a tree on the left, search on the right, and a running count of what you’ve selected.`}),_jsx(_components.p,{children:`Each selection becomes a dataset. Dataset names must be unique across your tenant, and the wizard suggests a unique name when there’s a conflict.`}),_jsx(Frame,{caption:`Step 3: pick the datasets to bring in`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=a0a3f0efb8264fd1a0b9a171c6d4eadc`,alt:`An 'Add datasets to this connector' dialog with a checkbox tree on the left rooted at '/' showing DEMO_DB, SNOWFLAKE, SNOWFLAKE_LEARNING_DB, and SNOWFLAKE_SAMPLE_DATA, and a searchable list on the right showing the same four entries each tagged with a yellow DATABASE badge and a drill-in chevron, above a footer reading '0 datasets selected' with Cancel and Add dataset buttons.`,\"data-og-width\":`1818`,width:`1818`,\"data-og-height\":`1518`,height:`1518`,\"data-path\":`images/features/connectors/wizard-add-datasets.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=d32573a72e0e40c99199ee385593064e 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=0e4782aea16f79d0476462285c298d5f 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=ac05ec03c6cf9ba8277882a7d02831b3 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=444b473111a545e1f51d2b216b887015 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=8281b234b90f501d1a3afb193027e298 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/wizard-add-datasets.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=2dc0db16e47613c1df559f31d4f06518 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`manage-a-connection`,children:`Manage a connection`}),`\n`,_jsxs(_components.p,{children:[`Click any row on the `,_jsx(_components.strong,{children:`Data`}),` tab to open its detail page.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Configuration \u0026 stored secrets`}),`: the non-secret fields (project, host, account) and which secrets are stored. Secret values are never shown after save; they render as `,_jsx(_components.code,{children:`****`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Test connection`}),`: re-check credentials and reachability at any time.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Edit`}),`: update credentials when they rotate, or change configuration such as the warehouse, role, or region.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Disconnect`}),`: disconnect every dataset in this connection at once, leaving the definitions in place. Other connections aren’t affected, and you can reconnect later.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Delete`}),`: permanently remove the connection, its credentials, and all of its datasets.`]}),`\n`]}),`\n`,_jsx(Frame,{caption:`A connection's detail page`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connection-detail.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=8e31f31398f72719a11b41995319b5c1`,alt:`The detail page for a connection named bq_test with a green status dot, a rename pencil, Test connection and Edit buttons, and a ⋮ menu. A 'Configuration \u0026 stored secrets' panel shows bigquery_project_id set to bigqueryproject-490617 and CON_BQ_TEST_BIGQUERY_SERVICE_ACCOUNT_JSON masked as asterisks. Below, Datasets and Refresh history tabs sit above a table of datasets: customer, lineitem, nation, orders, part, partsupp, each with its source path, a 'Daily at 4:45 pm' refresh with either a green check 'Last 20h ago' or a red 'Failed Aug 5', a 'Full refresh' strategy chip, and per-row refresh and ⋮ controls.`,\"data-og-width\":`1650`,width:`1650`,\"data-og-height\":`1614`,height:`1614`,\"data-path\":`images/features/connectors/connection-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connection-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=f5ee9f0b12c9294cced46c1c22c3dfff 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connection-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=2de4220ab3aa3b631a21df5a4cb562b1 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connection-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=e6615c4023963fcc728141c6fe43f618 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connection-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=7a34dbd3e00a189d0117d8ad0bbcc64b 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connection-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=337cad865eb573c3a4c96debc6d83932 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/connection-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=a7246e1b13d4f549212dff6eeab5d176 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Connection statuses.`}),` The colored dot on each connection shows its current state.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Color`}),_jsx(_components.th,{children:`What it means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Active`})}),_jsx(_components.td,{children:`Green`}),_jsx(_components.td,{children:`The connection is healthy and its datasets are queryable`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Processing`})}),_jsx(_components.td,{children:`Yellow`}),_jsx(_components.td,{children:`Datasets are deploying or syncing in the background`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Error`})}),_jsx(_components.td,{children:`Red`}),_jsx(_components.td,{children:`The last operation failed. Open the connection to see what went wrong`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Disconnected`})}),_jsx(_components.td,{children:`Grey`}),_jsx(_components.td,{children:`The connection is paused. Datasets stay defined but no queries run until you reconnect`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`datasets-and-refresh`,children:`Datasets and refresh`}),`\n`,_jsxs(_components.p,{children:[`A connection’s `,_jsx(_components.strong,{children:`Datasets`}),` tab lists everything it brings in: the dataset name, its source reference, when it refreshes, how the last refresh went, and the sync `,_jsx(_components.strong,{children:`Strategy`}),`. Use `,_jsx(_components.strong,{children:`+ Add dataset`}),` to bring in more, the per-row refresh button to sync one now, and the `,_jsx(_components.strong,{children:`Refresh history`}),` tab to see past runs across the connection.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Sync strategies.`}),` How each refresh updates the stored copy.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Strategy`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Full refresh`})}),_jsx(_components.td,{children:`Replaces the dataset with a complete re-read of the source`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Incremental (append)`})}),_jsx(_components.td,{children:`Reads only new rows since the last run and appends them`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Incremental (merge)`})}),_jsx(_components.td,{children:`Reads only what changed and merges it into existing rows`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Incremental (window)`})}),_jsx(_components.td,{children:`Re-reads a moving time window and replaces just that slice`})]})]})]}),`\n`,_jsx(_components.p,{children:`Incremental strategies need a column to track progress by, typically an updated-at timestamp or an increasing id.`}),`\n`,_jsx(Heading,{level:`2`,id:`connect-an-app`,children:`Connect an app`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Apps`}),` tab lists app integrations grouped by category: AI, Analytics, Commerce, and more. Click `,_jsx(_components.strong,{children:`+`}),` on an app to review what it does, then `,_jsx(_components.strong,{children:`Connect`}),`. Most apps hand off to that provider’s sign-in to authorize access. Once connected, Addison can work with the app directly in a chat.`]}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Frame,{caption:`Available apps, by category`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/QbY2IgDQcxPuEwtB/images/features/connectors/apps-tab.png?fit=max\u0026auto=format\u0026n=QbY2IgDQcxPuEwtB\u0026q=85\u0026s=3e79cc34acf01ff58d4e2807608b8e90`,alt:`The Apps tab of the Connectors page, selected alongside a Data tab, with an Add custom app button top-right and a search field. Available apps are grouped by category: AI with Exa ('Search and extract structured content from across the internet with Exa.'), and Analytics with Domo ('Connect to Domo analytics, datasets, dashboards, and business intelligence workflows.'), PostHog ('Analyze PostHog events, product analytics, feature flags, experiments, and sessions.'), and Tableau ('Access Tableau sites, projects, workbooks, views, and analytics assets.'). Each card has an icon, a description, and a + button to connect.`,\"data-og-width\":`3014`,width:`3014`,\"data-og-height\":`1490`,height:`1490`,\"data-path\":`images/features/connectors/apps-tab.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/QbY2IgDQcxPuEwtB/images/features/connectors/apps-tab.png?w=280\u0026fit=max\u0026auto=format\u0026n=QbY2IgDQcxPuEwtB\u0026q=85\u0026s=563c99bd1663ab2f67605456728dd5bf 280w, https://mintcdn.com/summation-676748f5/QbY2IgDQcxPuEwtB/images/features/connectors/apps-tab.png?w=560\u0026fit=max\u0026auto=format\u0026n=QbY2IgDQcxPuEwtB\u0026q=85\u0026s=ad2ba761730538489cf982200c6d257a 560w, https://mintcdn.com/summation-676748f5/QbY2IgDQcxPuEwtB/images/features/connectors/apps-tab.png?w=840\u0026fit=max\u0026auto=format\u0026n=QbY2IgDQcxPuEwtB\u0026q=85\u0026s=4ae8102d7e07fb734eafee08b483de44 840w, https://mintcdn.com/summation-676748f5/QbY2IgDQcxPuEwtB/images/features/connectors/apps-tab.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QbY2IgDQcxPuEwtB\u0026q=85\u0026s=72e36149b004879958559f4d34820072 1100w, https://mintcdn.com/summation-676748f5/QbY2IgDQcxPuEwtB/images/features/connectors/apps-tab.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QbY2IgDQcxPuEwtB\u0026q=85\u0026s=52e28f0ef143dec4c3e584b442203d69 1650w, https://mintcdn.com/summation-676748f5/QbY2IgDQcxPuEwtB/images/features/connectors/apps-tab.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QbY2IgDQcxPuEwtB\u0026q=85\u0026s=b40363b012ca65c753d643650e227b64 2500w`})}),_jsx(Frame,{caption:`Review an app before connecting`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/app-connect-dialog.png?fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=3ebecbb95a62ac14a8c5a4e91d11a593`,alt:`A connect dialog for Shopify headed 'Give Summation access to your Shopify connector', listing three points: 'Use Shopify in Addison — Manage Shopify products, orders, customers, inventory, and commerce workflows', 'Your data stays yours — Summation does not train models on your connector content. Addison uses this connection only to answer your requests', and 'You control access — Disconnect anytime from MCP settings'. A note reads 'Third-party connectors are not built or maintained by Summation. Review the permissions before connecting. Usage is subject to the Summation Privacy Policy.' above a Connect button.`,\"data-og-width\":`1042`,width:`1042`,\"data-og-height\":`1346`,height:`1346`,\"data-path\":`images/features/connectors/app-connect-dialog.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/app-connect-dialog.png?w=280\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=86acb57cd13864ed3b480b0d76f58c63 280w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/app-connect-dialog.png?w=560\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=dab050785748ab3233c3e445ccf97fe2 560w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/app-connect-dialog.png?w=840\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=0df5cc573c65ade7339541f0a9fc004a 840w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/app-connect-dialog.png?w=1100\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=40e3fec07f019faea57b05b2378b5ed1 1100w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/app-connect-dialog.png?w=1650\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=375c3fb5be2157a22762e20abe077601 1650w, https://mintcdn.com/summation-676748f5/bD5B6OO2CVOWNhOR/images/features/connectors/app-connect-dialog.png?w=2500\u0026fit=max\u0026auto=format\u0026n=bD5B6OO2CVOWNhOR\u0026q=85\u0026s=a9ee25e71125452861fe769b3b06ebdc 2500w`})})]}),`\n`,_jsxs(_components.p,{children:[`Connected apps move to a `,_jsx(_components.strong,{children:`Connected`}),` section at the top of the tab, where you can view the connector’s details or `,_jsx(_components.strong,{children:`Disconnect`}),` it. If the app you need isn’t listed, `,_jsx(_components.strong,{children:`Request an app`}),` tells us what to add, and a `,_jsx(_components.strong,{children:`custom MCP server URL`}),` connects one we don’t list.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Third-party apps aren’t built or maintained by Summation, so review the permissions before connecting. Summation doesn’t train models on your connector content, and you can disconnect at any time.`})}),`\n`,_jsx(Card,{title:`Apps`,icon:`grid-2`,href:`/features/connectors/apps`,children:_jsx(_components.p,{children:`Available apps by category, connecting one, and adding a custom app`})}),`\n`,_jsx(Visibility,{for:`agents`,children:_jsx(Warning,{children:_jsxs(_components.p,{children:[`Connecting an app isn’t enough to use it in a chat. The composer’s connector submenu is enabled per workspace, lists only `,_jsx(_components.strong,{children:`Active`}),` connectors, and each one has a per-chat enable toggle that must be turned on for that conversation.`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`supported-data-sources`,children:`Supported data sources`}),`\n`,_jsx(_components.p,{children:`Each guide documents the fields that connector’s form asks for, where to find the values, and what the common errors mean.`}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Snowflake`,icon:`snowflake`,href:`/features/connectors/snowflake`,children:_jsx(_components.p,{children:`Cloud data warehouse`})}),_jsx(Card,{title:`BigQuery`,icon:`google`,href:`/features/connectors/bigquery`,children:_jsx(_components.p,{children:`Google Cloud data warehouse`})}),_jsx(Card,{title:`Databricks`,icon:`gears`,href:`/features/connectors/databricks`,children:_jsx(_components.p,{children:`SQL Warehouse, Spark Connect, or Delta Lake`})}),_jsx(Card,{title:`Postgres`,icon:`database`,href:`/features/connectors/postgres`,children:_jsx(_components.p,{children:`PostgreSQL and compatible databases`})}),_jsx(Card,{title:`Redshift`,icon:`database`,href:`/features/connectors/redshift`,children:_jsx(_components.p,{children:`Amazon Redshift data warehouse`})}),_jsx(Card,{title:`MySQL`,icon:`database`,href:`/features/connectors/mysql`,children:_jsx(_components.p,{children:`MySQL and compatible databases`})}),_jsx(Card,{title:`SQL Server`,icon:`database`,href:`/features/connectors/mssql`,children:_jsx(_components.p,{children:`Microsoft SQL Server and compatible databases`})}),_jsx(Card,{title:`ClickHouse`,icon:`bolt`,href:`/features/connectors/clickhouse`,children:_jsx(_components.p,{children:`Columnar OLAP database`})}),_jsx(Card,{title:`MongoDB`,icon:`database`,href:`/features/connectors/mongodb`,children:_jsx(_components.p,{children:`Document database collections`})}),_jsx(Card,{title:`Oracle`,icon:`database`,href:`/features/connectors/oracle`,children:_jsx(_components.p,{children:`Oracle Database, including Autonomous DB`})}),_jsx(Card,{title:`MotherDuck`,icon:`duck`,href:`/features/connectors/motherduck`,children:_jsx(_components.p,{children:`Hosted DuckDB`})}),_jsx(Card,{title:`REST API`,icon:`braces`,href:`/features/connectors/http`,children:_jsx(_components.p,{children:`JSON APIs over HTTP`})}),_jsx(Card,{title:`Datadog`,icon:`chart-line`,href:`/features/connectors/datadog`,children:_jsx(_components.p,{children:`Filtered logs, metric points, monitor inventory, and log aggregates`})}),_jsx(Card,{title:`S3`,icon:`bucket`,href:`/features/connectors/s3`,children:_jsx(_components.p,{children:`AWS object storage (Parquet, CSV, JSON)`})}),_jsx(Card,{title:`Apache Iceberg`,icon:`layer-group`,href:`/features/connectors/iceberg`,children:_jsx(_components.p,{children:`Glue-backed or S3 warehouse lakehouse tables`})}),_jsx(Card,{title:`AWS Glue`,icon:`database`,href:`/features/connectors/glue`,children:_jsx(_components.p,{children:`S3-backed Iceberg, Parquet, and CSV tables`})}),_jsx(Card,{title:`GCS`,icon:`bucket`,href:`/features/connectors/gcs`,children:_jsx(_components.p,{children:`Google Cloud Storage`})}),_jsx(Card,{title:`Google Sheets`,icon:`table`,href:`/features/connectors/google-sheets`,children:_jsx(_components.p,{children:`Worksheet tabs as refreshed tables`})}),_jsx(Card,{title:`GitHub`,icon:`github`,href:`/features/connectors/github`,children:_jsx(_components.p,{children:`Code repositories and issues`})})]}),`\n`,_jsx(_components.p,{children:`If you don’t see the source you need, tell us. Connectors are added regularly.`}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Test connection fails immediately.`}),` Double-check the host, the port, and that your network or firewall allows traffic from Summation’s egress IPs.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Test connection succeeds but datasets fail to load.`}),` This is usually a permissions problem on the source side. Check that the user or role you provided has read access to the schemas and tables you want.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Secrets seem to disappear after editing.`}),` Secret fields are write-only. They render blank after save, but the stored value is still there until you overwrite it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Dataset name conflicts.`}),` Names must be unique across the tenant. Rename in the wizard before deploying.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A dataset shows a failed refresh.`}),` Open the connection’s `,_jsx(_components.strong,{children:`Refresh history`}),` for the run’s error, then re-run that dataset with its row refresh button.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If a problem persists, copy the error from the `,_jsx(_components.strong,{children:`Test connection`}),` result and contact support.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connectors","sidebarTitle":"Overview","description":"Bring your warehouses, databases, cloud storage, and the apps your team already uses into Summation.","href":"/features/connectors"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Terminology","slug":"terminology","depth":2,"children":[]},{"title":"Add a data connection","slug":"add-a-data-connection","depth":2,"children":[]},{"title":"Manage a connection","slug":"manage-a-connection","depth":2,"children":[]},{"title":"Datasets and refresh","slug":"datasets-and-refresh","depth":2,"children":[]},{"title":"Connect an app","slug":"connect-an-app","depth":2,"children":[]},{"title":"Supported data sources","slug":"supported-data-sources","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/summation-676748f5/109fb4ec55c4f518/theme-toggle.js","/_mintlify/custom/summation-676748f5/767147eed46ae967/toc-indicator.js","/_mintlify/custom/summation-676748f5/82e2d1909a80e450/sidebar-collapse.js"],"subdomain":"summation-676748f5","siteName":"Summation","title":"Connectors - Summation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-15T03:29:43.598Z","originalFileLocation":"features/connectors.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Bring your warehouses, databases, cloud storage, and the apps your team already uses into Summation.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Summation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connectors - Summation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Bring your warehouses, databases, cloud storage, and the apps your team already uses into Summation.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Summation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.summation.com/features/connectors\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://summation-676748f5.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Connectors\u0026amp;description=Bring+your+warehouses%2C+databases%2C+cloud+storage%2C+and+the+apps+your+team+already+uses+into+Summation.\u0026amp;theme=1190c7185ed5fee9aa38321d\u0026amp;signature=9d6d75b363e72e3d657916a0ee2e603bfc7755d21a59c341e2eccc0215f74a45\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connectors - Summation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Bring your warehouses, databases, cloud storage, and the apps your team already uses into Summation.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://summation-676748f5.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Connectors\u0026amp;description=Bring+your+warehouses%2C+databases%2C+cloud+storage%2C+and+the+apps+your+team+already+uses+into+Summation.\u0026amp;theme=1190c7185ed5fee9aa38321d\u0026amp;signature=9d6d75b363e72e3d657916a0ee2e603bfc7755d21a59c341e2eccc0215f74a45\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/summation-676748f5/s-DowS6hFbVgFajy/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Summation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.summation.com/features/connectors\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/features/connectors.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.summation.com/#organization\",\"name\":\"Summation\",\"url\":\"https://docs.summation.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/summation-676748f5/VNNtt3ifsblE4Ta9/images/summation-logo.svg?fit=max\u0026auto=format\u0026n=VNNtt3ifsblE4Ta9\u0026q=85\u0026s=6d050102e07df435f3532e1a4e34e685\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.summation.com#website\",\"name\":\"Summation\",\"url\":\"https://docs.summation.com\",\"publisher\":{\"@id\":\"https://docs.summation.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.summation.com/features/connectors#webpage\",\"url\":\"https://docs.summation.com/features/connectors\",\"name\":\"Connectors\",\"description\":\"Bring your warehouses, databases, cloud storage, and the apps your team already uses into Summation.\",\"dateModified\":\"2026-09-15T03:29:43.598Z\",\"isPartOf\":{\"@id\":\"https://docs.summation.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.summation.com/features/connectors#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.summation.com/features/connectors#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Summation\",\"item\":\"https://docs.summation.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connectors\",\"item\":\"https://docs.summation.com/features/connectors\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.summation.com/features/connectors#article\",\"headline\":\"Connectors\",\"name\":\"Connectors\",\"description\":\"Bring your warehouses, databases, cloud storage, and the apps your team already uses into Summation.\",\"url\":\"https://docs.summation.com/features/connectors\",\"mainEntityOfPage\":{\"@id\":\"https://docs.summation.com/features/connectors#webpage\"},\"dateModified\":\"2026-09-15T03:29:43.598Z\",\"publisher\":{\"@id\":\"https://docs.summation.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.summation.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Summation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Summation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/features/connectors.md","siteName":"Summation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Get started","pages":[{"title":"What is Summation?","href":"/introduction"},{"title":"Connect your data","sidebarTitle":"1. Connect your data","href":"/get-started/connect-your-data"},{"title":"Create your first analysis","sidebarTitle":"2. Create your first analysis","href":"/get-started/first-artifact"},{"title":"Refine your business context","sidebarTitle":"3. Refine your business context","href":"/get-started/build-your-context"},{"title":"Automate your first workflow","sidebarTitle":"4. Automate your first workflow","href":"/get-started/first-workflow"}]},{"group":"Key concepts","pages":[{"title":"Addison","href":"/features/addison"},{"title":"Projects","href":"/features/projects"},{"group":"Artifacts","pages":[{"title":"Verified Artifacts","sidebarTitle":"Overview","href":"/features/artifacts"},{"title":"Verification","href":"/features/artifacts/verification"},{"title":"Reports","href":"/features/artifacts/reports"},{"title":"Dashboards","href":"/features/artifacts/dashboards"},{"title":"Decks","href":"/features/artifacts/decks"},{"title":"Playbooks","href":"/features/artifacts/playbooks"},{"title":"Excel","href":"/features/artifacts/excel"},{"title":"HTML","href":"/features/artifacts/html"}]},{"title":"Workflows","href":"/features/workflows"},{"title":"Applications","href":"/features/applications"},{"group":"Tables","pages":[{"title":"Tables","sidebarTitle":"Overview","href":"/features/tables"},{"title":"Data table","href":"/features/tables/data"},{"title":"Source table","href":"/features/tables/source"},{"title":"Calculation table","href":"/features/tables/calculation"},{"title":"Dimension table","href":"/features/tables/dimension"},{"title":"Views","href":"/features/tables/views"}]},{"title":"Knowledge","href":"/features/knowledge"},{"title":"Skills","description":"Teach Addison how your team does a particular job, so every run follows the same steps.","href":"/features/skills"}]},{"group":"Connectors","pages":[{"title":"Connectors","sidebarTitle":"Overview","href":"/features/connectors"},{"title":"Apps","description":"Connect the tools your team already uses. Addison meets you there.","href":"/features/connectors/apps"},{"title":"Snowflake","href":"/features/connectors/snowflake"},{"title":"BigQuery","href":"/features/connectors/bigquery"},{"title":"Databricks","href":"/features/connectors/databricks"},{"title":"Postgres","href":"/features/connectors/postgres"},{"title":"Redshift","href":"/features/connectors/redshift"},{"title":"MySQL","href":"/features/connectors/mysql"},{"title":"SQL Server","href":"/features/connectors/mssql"},{"title":"ClickHouse","href":"/features/connectors/clickhouse"},{"title":"MongoDB","href":"/features/connectors/mongodb"},{"title":"Oracle","href":"/features/connectors/oracle"},{"title":"MotherDuck","href":"/features/connectors/motherduck"},{"title":"REST API","href":"/features/connectors/http"},{"title":"Datadog","href":"/features/connectors/datadog"},{"title":"S3","href":"/features/connectors/s3"},{"title":"Apache Iceberg","href":"/features/connectors/iceberg"},{"title":"AWS Glue","href":"/features/connectors/glue"},{"title":"GCS","href":"/features/connectors/gcs"},{"title":"Google Sheets","href":"/features/connectors/google-sheets"},{"title":"GitHub","href":"/features/connectors/github"}]},{"group":"Agent integrations","pages":[{"title":"Claude Plugin","href":"/integrations/claude-plugin"},{"title":"Codex Plugin","href":"/integrations/codex-plugin"},{"title":"MCP Server","href":"/integrations/mcp-server"}]}]},{"tab":"Use cases","icon":"lightbulb","pages":[{"title":"Use cases","href":"/use-cases/overview"}]},{"tab":"API","icon":"code","pages":[{"title":"API","href":"/api/overview"}]}]},"basePath":"","title":"Connectors - Summation","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DBAS9Liu.js","DynamicMarkdown-C4w9kavL.js","zoom-image-lightbox-B9O1U98p.js","lightbox-handle-r17bVUz3.js"]}