Use Roysa inside ChatGPT, Claude, Claude Code and Codex

Connect Roysa once and your assistant can read, extract from, review and compare documents with TrueTrace, and tell you the page and position behind every answer.

Connector address https://mcp.roysa.ai/mcp

You sign in with your Roysa account when you connect. There is no API key to paste.

Claude

Works in Claude on the web, the desktop app and mobile.

  1. Open Customize > Connectors.
  2. Select Add, then Add custom connector.
  3. Name it Roysa, paste the connector address, and click Continue.
  4. Keep the sign-in settings Claude detects and click Add.
  5. Click Connect, sign in to Roysa, and choose Allow.

In a chat, click the + button, select Connectors, and turn Roysa on. Give Claude a link to a document and ask your question.

On Team and Enterprise plans, an Owner adds the connector under Organization settings > Connectors (Add, then Custom). Each member then clicks Connect under Customize > Connectors and signs in with their own Roysa account.

Claude Code

Run these two commands in a terminal:

claude mcp add --transport http roysa https://mcp.roysa.ai/mcp
claude mcp login roysa

The second command opens your browser to sign in to Roysa. You can also run /mcp inside Claude Code and choose roysa. Then ask for what you need, for example: “Use Roysa to extract the invoice number and total from ./invoices/march.pdf.” Claude Code uploads local files for you.

ChatGPT

  1. Open chatgpt.com/plugins.
  2. Select the plus button, then Add custom MCP server.
  3. Enter a name (Roysa) and a short description.
  4. Under Connection, enter the connector address.
  5. Choose OAuth sign-in, read the notice, select I understand and want to continue, then Create as a plugin.
  6. Sign in to Roysa and choose Allow.

Start a new conversation, type @ and pick Roysa, attach a document, and ask your question.

Whether you can add a custom server depends on your ChatGPT plan and, at work, on your workspace's settings.

Codex

Run these two commands in a terminal:

codex mcp add roysa --url https://mcp.roysa.ai/mcp
codex mcp login roysa

Reading a long document can take longer than Codex's default limit of 60 seconds per tool call. Raise the limit in ~/.codex/config.toml:

[mcp_servers.roysa]
url = "https://mcp.roysa.ai/mcp"
tool_timeout_sec = 300

The Codex CLI, the IDE extension and the ChatGPT desktop app share this configuration.

Other apps, and signing in with an API key

Any app that supports MCP over Streamable HTTP can use the same address. Apps that cannot open a browser to sign in can send a Roysa API key instead, as a bearer token. Create a key on your API page, keep it in an environment variable, and pass it in the Authorization header:

claude mcp add --transport http roysa https://mcp.roysa.ai/mcp \
  --header "Authorization: Bearer $ROYSA_API_KEY"

In Codex, add bearer_token_env_var = "ROYSA_API_KEY" to the block above instead of signing in.

What your assistant can do

Getting a file to Roysa

Uploaded files and generated files, such as a redacted PDF, are private to your account and are deleted after one day.

What it costs

Connected apps use your Roysa credits at the same rates as the API. Your assistant can show the cost of each task before running it. See pricing.

Privacy and control

Apps connected to your account

Sign in to see the apps connected to your Roysa account.