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.
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.
- Open Customize > Connectors.
- Select Add, then Add custom connector.
- Name it Roysa, paste the connector address, and click Continue.
- Keep the sign-in settings Claude detects and click Add.
- 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
- Open chatgpt.com/plugins.
- Select the plus button, then Add custom MCP server.
- Enter a name (Roysa) and a short description.
- Under Connection, enter the connector address.
- Choose OAuth sign-in, read the notice, select I understand and want to continue, then Create as a plugin.
- 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
- Read a document as clean Markdown, including scanned pages and tables.
- Extract fields you name, or nested data such as line items, each with a confidence score and its place on the page.
- Answer a question from a document and show the passages the answer rests on.
- Review a document against your requirements, with a pass or fail for each one.
- Compare up to ten documents field by field, such as contract versions or competing quotes.
- Classify a document, or split a combined PDF into the documents inside it.
- Find and redact sensitive information, find locations, and translate a document while keeping its layout.
- Show you where. For PDFs and images, results come with an annotated copy of the document: each value outlined and numbered on the page where it was read, with a legend. Ask your assistant for the link.
Getting a file to Roysa
- A link. Give your assistant an
https://link to the file (up to 50 MB). - An attachment. In ChatGPT, attach the file to your message.
- A file on your computer. Your assistant asks Roysa for a one-time upload link. Claude Code and Codex upload the file themselves; in other apps you open the link and choose the file (up to 30 MB).
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
- You sign in on roysa.ai. The app you connect never sees your password.
- Each connection gets its own key that can only run document tasks. It cannot open the files stored in your Roysa library or change your account.
- You can disconnect an app at any time, here or in the app itself.
Apps connected to your account
Sign in to see the apps connected to your Roysa account.
No apps are connected to your account.