# 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.**

```
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](https://soontra.com/docs/connect) 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.**

```
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.**

```bash
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](https://soontra.com/docs/call-from-code).

## Next

- [Scopes](https://soontra.com/docs/scopes): what each access level allows.
- [Tool reference](https://soontra.com/docs/tools): what the app can call.
- [Limits](https://soontra.com/docs/limits): rate limits, page sizes and upload sizes.