> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vizkraft.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add connectors

> Connect Vizkraft to your databases and MCP servers so your team can start asking questions.

Use the `Connectors` area to add the data sources your team wants to analyze.

<img src="https://mintcdn.com/na-13f69f9a/5y83W_-rWwZHrw90/public/screenshots/connectors-list-f1.png?fit=max&auto=format&n=5y83W_-rWwZHrw90&q=85&s=3ba4df859bcc60dd84aa8d8560654e4e" alt="Connectors page showing the saved ShopNova connector" width="3024" height="1646" data-path="public/screenshots/connectors-list-f1.png" />

## Connector types available in the app

Vizkraft currently lets customers add:

| Type              | Best for                                              |
| ----------------- | ----------------------------------------------------- |
| PostgreSQL        | Managed SQL warehouse or application database         |
| MySQL             | Managed SQL databases                                 |
| ClickHouse        | Analytics databases                                   |
| MongoDB           | Document collections and NoSQL analytics              |
| HubSpot           | CRM data — contacts, companies, deals, and properties |
| Custom MCP server | Your own MCP-compatible tools and data sources        |

Some connector types may appear as coming soon in the UI. Those are not available until they are enabled in your workspace.

## Add a new connector

1. Open `Connectors`.
2. Select **Add connector**.
3. Choose the connector type you want to add.
4. Enter the connection details shown in the form (or authorize HubSpot via OAuth).
5. Test the connection.
6. Save the connector.

<img src="https://mintcdn.com/na-13f69f9a/5y83W_-rWwZHrw90/public/screenshots/connectors-add-picker.png?fit=max&auto=format&n=5y83W_-rWwZHrw90&q=85&s=91a4755bc838da8b55c0d15c17979c1b" alt="Add connector screen with managed databases and custom MCP server options" width="3024" height="1646" data-path="public/screenshots/connectors-add-picker.png" />

<Note>
  Saving a SQL or MongoDB connector automatically starts an initial indexing run, which uses one slot from your monthly indexing-runs allowance (Pro 5/mo, Business 20/mo, Enterprise unlimited). You can see your remaining runs on `Profile → Usage`. See [Indexing runs and your plan](/guides/index-your-data#indexing-runs-and-your-plan) for the full breakdown.
</Note>

## Managed database connectors vs HubSpot vs custom MCP

### Managed database connectors

Use PostgreSQL, MySQL, ClickHouse, or MongoDB when you want Vizkraft to connect directly to a supported database. This is the fastest path if your data is already in one of these systems.

After saving, open **Indexing** to let Vizkraft read your schema. See [Index your data](/guides/index-your-data).

### HubSpot CRM

Use HubSpot when your questions are about CRM objects — contacts, companies, deals, tickets, and their properties.

HubSpot uses an OAuth connect flow and a **catalog sync** instead of SQL indexing. See [HubSpot CRM sync](/guides/crm-sync).

### Custom MCP server

Use this when your team already has an MCP-compatible server or when you want Vizkraft to access tools beyond a single managed connector.

## Connector row actions

Each saved connector exposes quick actions from the connectors list:

| Action                           | Available for                                  | What it does                                                |
| -------------------------------- | ---------------------------------------------- | ----------------------------------------------------------- |
| **Indexing** or **Catalog sync** | SQL/MongoDB → Indexing; HubSpot → Catalog sync | Open the schema or CRM catalog workflow                     |
| **Memory**                       | All connectors                                 | Review and edit what Vizkraft has learned about this source |
| **Evaluation**                   | SQL connectors only                            | Measure accuracy and manage golden test cases               |
| **Edit connection**              | All connectors                                 | Update credentials or settings                              |
| **Remove connector**             | All connectors                                 | Disconnect the source                                       |

Open **Memory** or **Evaluation** from the **⋯** menu on the connector row.

## What to name a connector

Choose names that help people pick the right source in chat. Good examples:

* `Production PostgreSQL`
* `Marketing warehouse`
* `HubSpot CRM`
* `Finance MCP`
* `Customer support analytics`

## Edit or retest an existing connector

From the connectors list you can:

* Open a connector to review its status.
* Edit its settings.
* Run another connection test after credentials or endpoints change.
* Jump directly into indexing or catalog sync for supported sources.
* Open memory or evaluation from the **⋯** menu.

## Use one or more connectors in chat

After connectors are saved, they become available in chat. You can:

* Enable a single connector for a focused question.
* Enable multiple connectors when the answer needs information from more than one source.
* Switch connectors between questions without rebuilding the connector itself.

## Best practices

* Create one connector per stable data source rather than reusing a generic catch-all name.
* Test the connector before saving it so your first chat session starts smoothly.
* If a connector feeds charts or dashboards for multiple teams, give it a clear business name.
* Run indexing or catalog sync after setup for the best suggestions and answer quality.
* Review [Connector memory](/features/connector-memory) after your team has asked a few questions.

## Continue with indexing or CRM sync

* SQL and MongoDB connectors → [Index your data](/guides/index-your-data)
* HubSpot connectors → [HubSpot CRM sync](/guides/crm-sync)