# Connect an AI assistant

> Let Claude, ChatGPT, Cursor or another AI assistant draft, prepare and track Korala documents for you.

Source: https://docs.korala.ai/ai-agents

---

  This section describes a feature that is rolling out. Listings in the ChatGPT app directory, the Claude connectors directory, the MCP Registry and the Cursor Marketplace are pending, so for now you add Korala by its address.

Connect your AI assistant to Korala and ask for documents in plain language. The assistant drafts the agreement, creates a document for the people you name, and tells you who has signed. You stay the sender.

An assistant cannot sign for anyone. Korala also keeps signers' signing links and tokens out of everything the assistant sees.

## Three levels of trust

| Level | What the assistant can do | What you need |
| --- | --- | --- |
| No account | Turn a Markdown draft into an "Open in Korala" link. You open the link, review the draft and save it yourself. | Nothing. See [API key (CI and headless)](https://docs.korala.ai/ai-agents/api-key#draft-only-mode). |
| Connected | Read your documents and templates, save templates, and prepare draft documents. For sending, it hands you a link so you review and send the document yourself. | A Korala account where you are an Owner or Admin. |
| Trusted to send | Send and void documents after you ask for it in the conversation. | The **Send and void documents** permission, which starts off. |

## The address

Every assistant connects through one address:

```text
https://api.korala.ai/mcp
```

The address is an MCP server, the standard that AI assistants use to reach outside tools. You connect by signing in to Korala in your browser. You copy no API keys.

## How connecting works

1. Add the address above to your assistant. Each guide below shows where.
2. Your assistant opens a browser. Sign in to Korala and read the consent page. Pick the permissions.
3. Choose **Connect**. The browser returns you to your assistant, and Korala appears among its tools.

![Korala's consent page asks "Connect an AI assistant to Korala?", shows the assistant's name and host marked as unverified, lists four permission checkboxes with "Send and void documents" cleared, adds a note that it works with real documents, and ends with Cancel and Connect buttons.](https://docs.korala.ai/img/ai-agents/consent.png)

A connection works with your real documents. Leave **Send and void documents** off for your first try. The assistant then prepares drafts and gives you a link to review, and Korala emails nobody. Documents the assistant creates from templates count against your plan like your own. [Permissions and safety](https://docs.korala.ai/ai-agents/permissions) explains each choice on this page.

## Pick your assistant

| Assistant | Guide |
| --- | --- |
| Claude on the web, desktop and mobile | [Claude](https://docs.korala.ai/ai-agents/claude) |
| Claude Code | [Claude Code](https://docs.korala.ai/ai-agents/claude-code) |
| ChatGPT | [ChatGPT](https://docs.korala.ai/ai-agents/chatgpt) |
| OpenAI Codex | [Codex](https://docs.korala.ai/ai-agents/codex) |
| Cursor and VS Code | [Cursor and VS Code](https://docs.korala.ai/ai-agents/cursor-vscode) |
| Gemini CLI, Windsurf and any other MCP client | [Gemini CLI and others](https://docs.korala.ai/ai-agents/other-clients) |
| CI jobs and headless machines | [API key (CI and headless)](https://docs.korala.ai/ai-agents/api-key) |

## Try these prompts

- "Draft a one-page mutual NDA between Acme Inc. and Anna Miller (anna@example.com). Show me what it needs, save it as a template and create the document. Don't send it yet."
- "Do we have a template for a freelance services agreement? List its signer roles."
- "Which documents are still waiting for a signature, and who has not signed?"
- "Show me the audit trail for the Acme NDA."

## Working with a PDF you already have

An assistant can write an agreement itself as a [Markdown template](https://docs.korala.ai/guides/markdown-templates). When you have the PDF already, there are three ways to get it to the assistant:

- **Start in Korala.** Upload the PDF in the dashboard, open the document and press **Continue with your AI assistant**. Korala copies a prompt that names the document. Paste it into your chat and say who signs.
- **Start in the chat.** Ask the assistant to prepare the PDF for signing. It creates an empty draft and gives you a link to a Korala page where you upload the file. Tell the assistant when the upload is done, and it carries on: signers, fields, and sending when you say so.
- **Attach it (ChatGPT).** Attach the PDF to your message. ChatGPT hands the file to Korala. If the file does not come through, the assistant falls back to the upload link.

Coding agents such as Claude Code, Codex and Cursor read the file from your disk and upload it themselves.

## Next

- [Permissions and safety](https://docs.korala.ai/ai-agents/permissions): what each permission allows, and how to disconnect an assistant.
- [Tool reference](https://docs.korala.ai/ai-agents/tools): the 25 tools an assistant can call.
