OpenAI
Guide MCP
What is an MCP server?
An MCP server exposes structured tools to an AI client. With Foliade, Codex or Claude Code can convert a PDF, retrieve its link, and view its analytics without manually reproducing API calls.
A common server, two plugins
The same hosted server connects Codex and Claude Code to your account. Both plugins provide instructions for transferring a local PDF securely.
An application using the REST API must provide an account key. MCP uses OAuth for your account, or a private token limited to the upload for guest mode.
Before you start
MCP is included for free, with or without an account. Codex and Claude Code follow your plan permissions; their own access terms remain separate.
Install the plugin, connect your account and authorize access. No local server, API key or Python installation is required.
Connect your account in Codex
Installing the plugin does not connect your account yet. After installation, run this command in your computer's terminal, outside the Codex conversation:
codex mcp login foliadeOn the Foliade page that opens, sign in, check the account email and authorize the connection. Then return to your assistant.
If the browser does not open, open the link shown in the terminal. Do not share this sign-in link.
Wait for the terminal to confirm that login succeeded before continuing. There is no API key to copy.
Check the connection and send your first PDF · Install in Claude Code
Transferring a local PDF
The remote server cannot read files from a path on your computer. The plugin computes the selected file's size and SHA-256 digest, prepares an upload, transfers its bytes over HTTPS, then finalizes the draft.
The conversion is asynchronous. The assistant checks its result before announcing success. Public publication requires a separate action; the draft remains private by default.
Control and revoke access
In Foliade → API → Connected assistants, you can revoke each connection. Access ends immediately without deleting your catalogues.
These guides cover Codex and Claude Code with local file access. They do not guarantee attachment transfers in ChatGPT, Claude web, Claude Desktop or Cowork.
Anthropic