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

# Connectors

> The tools Synapse reads from, what each one gives it and never sees, the connection states, and the accounts you link for yourself

Connectors are how Synapse gets its data: your code host, chat, issue tracker, calendar and AI tools. There are two views of them.

* **Admin → Connectors** is the organization's sources. Synapse Admins connect them once, for everyone, and only they see this page in the menu.
* **You → My connections** is your own linked accounts. Only you see and change them.

What Synapse indexes as searchable text is chosen separately, under [Knowledge sources](https://docs.synheart.ai/synapse/knowledge-sources.md). Connecting a tool collects activity, never its text.

## Organization sources

**Admin → Connectors** lists every source, grouped by where it stands. Search the list, or choose **Refresh statuses** to check them all again.

![The Connectors page, with Slack under Needs attention, GitHub and Notion under Connected, Jira and Linear under Ready to connect, a Microsoft 365 group with four tools, and Zoom under Not set up](https://mintcdn.com/synheartai/bIbSKNEqulE95GhK/images/synapse/connectors-organization.png?fit=max\&auto=format\&n=bIbSKNEqulE95GhK\&q=85\&s=d53c6bbed91f2109cb1fc959ab5d403a)

Organization sources, grouped by status

| Group | Means |
| - | - |
| **Needs attention** | Connected, but something is wrong, such as an expired credential or a failed sync. The row says what happened, and **How to fix** or **Reconnect** shows what to do. |
| **Connected** | Working. The row shows when it last synced. |
| **Configured without API** | Set up, but with no automatic collection. Its figures come from a report you send in, such as an AI usage import. |
| **Ready to connect** | Available. Choose **Connect** to start. |
| **Included with paid plans** | On Synapse Free, only GitHub and Slack are included. Other sources keep their settings and data, and sync again when you upgrade. |
| **Microsoft 365** | Teams, OneDrive, Outlook Mail and Outlook Calendar, as one organization application. A Global Administrator approves each tool separately. See [Microsoft 365](https://docs.synheart.ai/synapse/microsoft-365.md). |
| **Not set up** | Not available in your environment yet. Your organization admin can help. |

Select a source to open its details: what Synapse reads from it, what it never sees, when it last synced, and when its credential expires.

## What each source gives Synapse

**Work and knowledge**

| Source | Synapse sees | Never |
| - | - | - |
| **GitHub** | Repository docs (Markdown, RFCs, ADRs); when PRs, issues and reviews happen; deploys and CI results. | Source code, diffs, PR or issue text, comments. |
| **GitLab** | Project docs; when merge requests and reviews happen; pipeline results. | Source code, diffs, comments. |
| **Slack** | When messages happen, mentions and after-hours activity. Text only from public channels added as [knowledge sources](https://docs.synheart.ai/synapse/knowledge-sources.md). | DMs, private channels, files. |
| **Notion** | Titles and plain text of the pages you share with Synapse. | Comments, attachments, pages you don't share. |
| **Linear**, **Jira** | Issue titles, who they're assigned to, and when their status changes. Used for cycle time and work in progress. | Descriptions, comments, attachments. |
| **Zoom** | When meetings happen and how long they last, for meeting load. | Recordings, transcripts, chat, who attended. |
| **Microsoft 365** | Depends on the tool. See [What each tool reads](https://docs.synheart.ai/synapse/microsoft-365.md#what-each-tool-reads). | |

For GitHub, you can also choose which deployments count as production. See [Production deploys](https://docs.synheart.ai/synapse/metrics.md#production-deploys).

**AI tools**

| Source | Synapse sees |
| - | - |
| **GitHub Copilot** | Seat counts and daily usage totals. |
| **Claude Code** | Usage totals and costs from the Console. |
| **Claude Enterprise** | Usage, costs and daily activity. |
| **OpenAI API** | How much was used and what it cost. |
| **ChatGPT Enterprise** | ChatGPT and Codex usage totals for the workspace. |
| **Cursor** | How much was used and what it cost. |
| **Google Vertex AI**, **AWS Bedrock**, **Azure OpenAI** | Model token and request counts from the cloud's monitoring, for the project, account or resource you connect. |

No AI tool connector sees prompts, responses or code. Cloud monitoring doesn't report who made a request, so those three give totals only. What these figures show is covered in [AI usage](https://docs.synheart.ai/synapse/ai-usage.md) and [AI spend](https://docs.synheart.ai/synapse/ai-spend.md).

## Disconnecting

Disconnecting a source stops new imports. What it already imported is kept, unless you tick **Also delete everything Synapse imported** when you disconnect. Knowledge sources and people's linked accounts aren't changed.

## Your connections

**You → My connections** is for you. Linking an account matches it to activity your organization has already connected, so Synapse knows which part is yours. **It doesn't import anything new.**

You can link GitHub, Slack, Linear, Jira, Notion, Google Drive, Google Calendar, Outlook Calendar, Outlook Mail, Microsoft Teams and OneDrive. Your linked accounts feed [My Effectiveness](https://docs.synheart.ai/synapse/my-effectiveness.md). Unlink any of them at any time.

The page also has:

* **Life by Synheart.** Connect Life to add your human state to My Effectiveness. Consent is given, and can be withdrawn, in the Life app.
* **Local telemetry.** Sent from the CLI on your own machine. It's off until you turn it on with `synheart synapse telemetry on`, which shows what is sent and asks first. It's content-free by design: never prompts, responses or code. **Delete local telemetry** removes every session you've sent.

## Who can do what

| Action | Who |
| - | - |
| Open **Admin → Connectors**; connect, sync and disconnect organization sources | Synapse Admins |
| Link and unlink your own accounts | Everyone, for themselves only |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.