🧩 How to connect Airparser MCP to Claude

You can connect Airparser MCP to Claude so Claude can work with your Airparser account directly.

Once connected, Claude can use Airparser actions to parse documents, inspect inboxes, list documents, retrieve parsed data, update schemas, and help with post-processing workflows.

Before you start

Make sure you have:

  • a Claude account with access to custom connectors

  • an Airparser account (you can start free, no credit card required)

  • your Airparser API key

You can find your Airparser API key here:

https://app.airparser.com/account

Option A: add Airparser from the Claude directory

This is the quickest way.

  1. In Claude, open Customize → Connectors (or go directly to https://claude.ai/customize/connectors) and open the Discover tab.

    Claude Customize, Connectors: searching for Airparser

  2. Search for Airparser, open it and click Connect to Claude.

    Airparser connector page with the Connect to Claude button

  3. On the Airparser authorization screen, paste your Airparser API key and click Connect to Airparser.

  4. Airparser now appears under Yours. Open it to choose which tools Claude may use (see Choose which tools Claude can use below).

  5. In a chat, open the input menu, choose Connectors and turn on Airparser.

Airparser's directory page: https://claude.ai/directory/airparser

Airparser is listed as a Community connector: Anthropic screens community connectors but has not reviewed them in depth. If you are on a Team or Enterprise plan, an organization owner may need to allow the connector first.

Option B: add it as a custom connector

Use this if Airparser does not show up in the directory for your plan, or if you prefer to add the server yourself.

Step 1. Open Claude connectors

In Claude, open Settings → Connectors (or go directly to https://claude.ai/customize/connectors).

Click Add, then Add custom connector.

Claude Settings, Connectors, Add custom connector

Step 2. Add the Airparser MCP server

In the custom connector form, enter:

  • Name: Airparser

  • Server URL: https://mcp.airparser.com

Then click Continue.

Add custom connector form with the Airparser server URL

Step 3. Keep the detected sign-in settings

Claude detects that Airparser uses sign-in and preselects the right options. Keep the defaults:

  • Authentication: Sign in now

  • OAuth client: Register automatically

You do not need to add any request headers. Confirm to add the connector.

Authentication settings: Sign in now and Register automatically

Step 4. Connect your Airparser account

Open the Airparser connector. If it says You’re not connected to Airparser yet, click Connect.

Airparser connector page with the Connect button

This opens the Airparser authorization screen.

Step 5. Authorize with your Airparser API key

Paste your Airparser API key and click Connect to Airparser.

Keep your API key secret: anyone with it can use your Airparser account. On this screen it is only used to authorize the connection.

If you need to copy your key, open your Airparser account page here:

https://app.airparser.com/account

Airparser Connect your account screen with the API key field

Step 6. Use Airparser MCP in Claude chat

Once connected, you can use Airparser MCP from inside Claude chats.

In the chat input, open the menu and select Connectors to access Airparser.

6 claude chat.jpg

Choose which tools Claude can use

After you connect, open the Airparser connector under Yours in Claude's connector settings. Tool permissions lists Airparser's tools in two groups: read-only tools (they only read data) and tools that change data. For each tool, or for a whole group, you can choose whether Claude may use it right away, has to ask for your approval first, or is blocked.

Airparser connector settings with the tool permissions

Right after connecting, the read-only tools are set to Needs approval. If you do not want to confirm every read, allow them. We suggest keeping approval on for the tools that change data, for example the ones that replace an extraction schema or saved post-processing code.

What you can do after connecting

Once Airparser MCP is connected, you can ask Claude to help with tasks like:

  • import new documents for parsing

  • list your Airparser inboxes

  • show the extraction schema for an inbox

  • list documents inside an inbox

  • retrieve parsed JSON for a document

  • generate or update an extraction schema

  • test or update post-processing Python code

Try it

Attach an invoice (PDF or image) and ask:

"Create an Airparser inbox called 'Test invoices', upload this invoice and show me the extracted data."

Claude creates the inbox (vision engine), generates the fields from your document, uploads it and shows the result. You can then open the inbox in the Airparser app to see the document and its fields.

More examples and the list of tools: What is Airparser MCP?

Things to know

  • Access lasts 90 days. After that, disconnect and connect again.

  • The connector works on the account whose API key you pasted. To use another account, disconnect and connect again with that account's key.

  • Very large files may not fit in a chat request. For those, upload in the Airparser app or by email to the inbox address.

  • If a parse takes more than 15 seconds, Claude gets the document id and fetches the result a moment later; the file does not need to be uploaded again.

Troubleshooting

If Claude shows the connector but never asks for your API key, or the connection stops working, reconnect:

  1. open the Airparser connector

  2. click Disconnect

  3. click Connect

  4. complete the Airparser authorization step

Also make sure the server URL is exactly https://mcp.airparser.com.

If Airparser tools are missing in a chat, turn the connector on in the chat input menu under Connectors. If they still do not appear, remove the connector and add it again.

If you still have trouble connecting, please contact Airparser support at support@airparser.com.

Was this article helpful?