Connectors

Cloud Connect

Documentation

Connect GitHub, Notion, and Figma — sync activity into your private Skill Graph.

Ready to connect?

Sign in and open Connectors to link your tools.

What are Connectors?

Connectors sync activity from GitHub, Notion, and Figma into your private Skill Graph. Vistai runs sync in the cloud — no local plugins or MCP config required.

Connect vs MCP

  • Connectors send data in from your tools (ingestion).
  • Vistai MCP lets AI assistants read your graph out (exposure).
  • Use both for the fullest picture: real tool activity + AI access in your IDE.
NoteConnector tokens are encrypted at rest and never exposed to MCP clients or public profiles.

Quick start

Connect your first tool in under a minute (Plus or Max required).

  1. 1Sign in and open Connectors from Settings.
  2. 2Click + on GitHub, Notion, or Figma.
  3. 3Complete OAuth (or paste a Figma personal access token).
  4. 4Wait for the first sync — usually under a minute.
  5. 5Open Skill Graph to see your domains update.

GitHub

Sync commits and coding activity into your Engineering domain on the Skill Graph.

Skill domain

Feeds your Engineering domain on the Skill Graph.

How to connect

  1. 1Click + on the GitHub connector card.
  2. 2Authorize Vistai in the OAuth screen.
  3. 3You will return to Connectors with a connected account label.

Notion

Pages you edit surface as writing activity across your integrated graph.

Skill domain

Feeds your Writing domain on the Skill Graph.

How to connect

  1. 1Click + on the Notion connector card.
  2. 2Authorize Vistai in the OAuth screen.
  3. 3You will return to Connectors with a connected account label.

Figma

Design file activity powers your Design domain — no desktop plugin required.

Skill domain

Feeds your Design domain on the Skill Graph.

How to connect

  1. 1Click + on the Figma connector card.
  2. 2Generate a personal access token in Figma Settings → Security.
  3. 3Paste the token in the modal and confirm.

How sync works

Vistai pulls recent activity from connected accounts and writes sanitized events to your Skill Graph.

  • Automatic sync after you connect.
  • Manual sync via Sync on each card or Sync all in the header.
  • Scheduled background sync on Plus (6h) and Max (1h) plans.
  • Activity is stored at skillGraphs/{uid}/activityLogs — private to you.

Security & privacy

Connectors are designed for encrypted, server-side access only.

  • OAuth tokens and Figma PATs are encrypted with AES-256-GCM.
  • Client apps never read raw tokens — Admin API only.
  • Disconnect revokes access and stops future syncs.
  • MCP and public profiles never expose connector credentials.

Troubleshooting

Common connector issues and fixes.

OAuth redirect errors

  • GitHub OAuth callback must exactly match your production URL (https + www).
  • See INTEGRATIONS.md (operators) for callback URL setup.

Figma token rejected

  • Use a personal access token with read access.
  • Generate a fresh token if the previous one was revoked.

No activity on Skill Graph

  • Confirm the connector shows Connected with an account name.
  • Tap Sync on the card or wait for the next scheduled sync.
  • Plus/Max required for integrated Skill Graph from connectors.