Docs Get started

Quickstart

Connect an AI app to your workspace and run a first prompt.

You need a Soontra workspace where you are an owner or admin, and an AI app that accepts a custom MCP server.

Connect by signing in

Chat apps such as ChatGPT, Claude, Gemini, Grok and Perplexity connect with a link and a sign-in. No key is involved.

  1. Copy Soontra’s link.

    MCP server URL
    https://app.soontra.com/api/mcp

  2. Add it to your AI app as a custom MCP server or custom connector.

    Each app keeps this in a different menu. The connect guides have the exact path for each.

  3. Sign in to Soontra when the app sends you there.

    Pick the workspace and an access level. Full access lets the app read your content and leave drafts. Tick Download files under Advanced options if you want media to show in the chat.

  4. Ask something.

    Test prompt
    List my projects in Soontra.

Connect with an API key

Editors and command-line tools such as Claude Code, Cursor and VS Code, and your own scripts, send a key with each request.

  1. Create a key.

    In Soontra, open Settings, API & MCP, switch to API, and choose Create New. Name it, pick its scopes, and copy it: it is shown once.

  2. Give the key to your tool as a Bearer token.

    Claude Code
    claude mcp add --transport http soontra https://app.soontra.com/api/mcp \
  --header "Authorization: Bearer <YOUR_KEY>"

  3. Check that it works.

    Ask the tool to list your Soontra projects, or call tools/list yourself as shown in Call it from code.

Next