# Connect your AI assistant
Source: https://docs.file.ai/mcp/connect

> Use fileAI's document tools from Claude, Codex, Cursor, ChatGPT or VS Code.

MCP server

# Connect your AI assistant

Copy pageCopy page

Use fileAI’s document tools from Claude, Codex, Cursor, ChatGPT or VS Code.

Copy pageCopy page

Once connected

**Extract structured data**Pull fields, tables and line items from your files.

**Check document integrity**Run fileForensics and review the findings.

**Work from your assistant**Use fileAI without switching applications.

Example prompts

What fileAI tools do you have access to?

Extract the key details from invoice-0423.pdf.

Run integrity checks on bank-statement-march.pdf.

Click a prompt to select it, then copy.[View all MCP tools →](/mcp/tools)

*   Claude
    
*   Codex
    
*   Cursor
    
*   ChatGPT
    
*   VS Code
    

1

Sign in with fileAI

Claude connects with your fileAI account, so you don’t need an API key. You need a Claude plan with custom connectors.

2

Add the connector

In Claude, open **Settings → Connectors → Add custom connector**:

Field

Value

Name

`fileAI`

Remote MCP server URL

`https://mcp.file.ai/mcp`

Click **Connect**, sign in to fileAI, choose the workspaces Claude may use, and click **Allow**. Logged in with the wrong account? Click **Not you?** to switch. Then switch on **fileAI** in a chat’s tools menu.

3

Test the connection

Ask Claude:

```
What fileAI tools do you have access to?
```

To upload files from Claude or switch projects, see [Claude: projects and uploads](/mcp/claude).

1

Get your API key

Create a project API key in your fileAI workspace, then store it as an environment variable:

```
export FILEAI_API_KEY="your-api-key"
```

API keys are created in the fileAI app[Open fileAI ↗](https://orion.file.ai/en)

2

Add the MCP server

Add fileAI to `~/.codex/config.toml`:

~/.codex/config.toml

```
[mcp_servers.fileai]
url = "https://mcp.file.ai/mcp"
env_http_headers = { "x-api-key" = "FILEAI_API_KEY" }
```

The key is read from the environment, so it never sits in the file.

3

Test the connection

Start a new session, run `/mcp`, then ask:

```
What fileAI tools do you have access to?
```

1

Get your API key

Create a project API key in your fileAI workspace.

API keys are created in the fileAI app[Open fileAI ↗](https://orion.file.ai/en)

2

Add the MCP server

Open **Cursor Settings → Tools & Integrations → MCP Tools → New MCP Server** and add:

mcp.json

```
{
  "mcpServers": {
    "fileAI": {
      "url": "https://mcp.file.ai/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY_HERE" }
    }
  }
}
```

Replace `YOUR_API_KEY_HERE` with your key, and don’t commit this file.

3

Test the connection

Ask in Cursor’s chat:

```
What fileAI tools do you have access to?
```

1

Get your API key

Create a project API key in your fileAI workspace. You also need a ChatGPT plan with Developer mode.

API keys are created in the fileAI app[Open fileAI ↗](https://orion.file.ai/en)

2

Add the connector

In **Settings → Connectors → Advanced settings**, turn on **Developer mode**. Then click **Create**:

Field

Value

Name

`fileAI`

MCP Server URL

`https://mcp.file.ai/mcp`

Authentication

Custom headers: `x-api-key: YOUR_API_KEY_HERE`

3

Test the connection

In a new chat, turn on **Developer mode** and **fileAI** from the tools menu, then ask:

```
What fileAI tools do you have access to?
```

1

Get your API key

Create a project API key in your fileAI workspace.

API keys are created in the fileAI app[Open fileAI ↗](https://orion.file.ai/en)

2

Add the MCP server

Add fileAI to your user-level `mcp.json`, or to `.vscode/mcp.json` in a workspace:

mcp.json

```
{
  "servers": {
    "fileAI": {
      "type": "http",
      "url": "https://mcp.file.ai/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY_HERE" }
    }
  }
}
```

Replace `YOUR_API_KEY_HERE` with your key. A workspace file is plain text, so don’t commit it.

3

Test the connection

Open Copilot Chat in agent mode and ask:

```
What fileAI tools do you have access to?
```

**Regional workspace?** Replace `mcp.file.ai` with `mcp.au.file.ai`, `mcp.sg.file.ai` or `mcp.jp.file.ai`. A key only works on the instance that issued it. Something not working? See [Troubleshooting](/api/troubleshooting#mcp).

[Previous](/mcp/overview)[

Tools reference

Every tool the fileAI MCP server exposes, with its parameters.

Next

](/mcp/tools)

⌘I

Once connected

**Extract structured data**Pull fields, tables and line items from your files.

**Check document integrity**Run fileForensics and review the findings.

**Work from your assistant**Use fileAI without switching applications.

Example prompts

What fileAI tools do you have access to?

Extract the key details from invoice-0423.pdf.

Run integrity checks on bank-statement-march.pdf.

Click a prompt to select it, then copy.[View all MCP tools →](/mcp/tools)