HummingDeck's MCP server connects Claude and ChatGPT to your workspace. Ask in your own words to share a document, build a Room, or see who read what, and the assistant does it in HummingDeck with the permissions you approve. You sign in with your HummingDeck account, so there is no key to copy.
Open Workspace → Integrations → AI assistants (MCP) and select Enable MCP. The card shows whether MCP is Enabled or Disabled for your workspace. Select Set up an assistant, then follow the Claude or ChatGPT steps below and approve the connection with an owner or admin account. On Free, Starter, or Pro, the enable control links to Billing to upgrade to Business.
Choose MCP or the API
- MCP is for working from Claude or ChatGPT in your own words. You sign in with your HummingDeck account and write no code. Start with Connect Claude or Connect ChatGPT.
- The REST API is for automations and integrations your team builds, signed in with a workspace API key. Start with API access and reference.
Choose MCP when a person drives the work from a chat. Choose the API when a workflow should run on its own, for example creating a personalized link for every new deal in your CRM.
What you can ask for
The assistant works with the documents, links, Rooms, and engagement of the workspace you connect. It can:
- find documents and show who opened them, page by page;
- create a tracked link for a person, with the access mode and notifications you choose;
- build a Room with documents, tabs, sections, and a link for each audience;
- publish an HTML page it wrote as a HummingDeck document, or prepare a secure HummingDeck page where you upload a file;
- update a mutual action plan and read or configure Room discussions;
- rename, replace, or delete documents, and archive Rooms.
Connect Claude
These steps work in Claude on the web and in Claude Desktop. Every Claude plan can add custom connectors; the Free plan allows one.
- In Claude, open Customize → Connectors, select Add, and add a custom connector.
- Enter HummingDeck as the name and
https://app.hummingdeck.com/mcpas the remote MCP server URL, then select Continue. - Under Authentication, choose Sign in now. Keep Use Claude's published identity (Recommended) as the OAuth client, then select Add.
- HummingDeck opens in your browser. Sign in, approve the connection, and return to Claude.
- In a chat, select + (or type /), open Connectors, and turn on HummingDeck.
When Claude asks to use a HummingDeck tool, choose Allow always only for actions you are comfortable letting it take without asking.
On Claude Team and Enterprise plans, an Owner first adds HummingDeck in Organization settings → Connectors with the same name and address. Each member then opens Customize → Connectors, finds HummingDeck, and selects Connect to sign in with their own HummingDeck account.
A connector you add on the web also works in Claude Desktop, and appears in the Claude mobile apps the next time you sign in.
Claude Code
Add HummingDeck from your terminal:
claude mcp add --transport http hummingdeck https://app.hummingdeck.com/mcp
Then run /mcp in Claude Code and sign in when your browser opens.
Connect ChatGPT
These steps work in ChatGPT on the web.
- Open ChatGPT Plugins, select +, then Add custom MCP server.
- Enter HummingDeck as the name. Under Connection, enter
https://app.hummingdeck.com/mcpas the Server URL. - Choose OAuth for authentication. Review the warning, select I understand and want to continue, then select Create as a plugin.
- Open the new plugin and install it. When ChatGPT asks you to sign in, sign in to HummingDeck and approve the connection.
- Start a new chat, type @, and select HummingDeck. If your ChatGPT home page shows Chat and Work, use Work.
By default, ChatGPT asks you to confirm actions that change something, such as creating a link or a Room.
In ChatGPT Business, Enterprise, and Edu, workspace settings can limit custom MCP servers. If Add custom MCP server is missing, ask your ChatGPT admin.
Approve the connection in HummingDeck
After you sign in, HummingDeck shows Connect an assistant:
- Check the application name and the address it returns to.
- Choose the workspace. You need to be an owner or admin there.
- Choose what the assistant can do: View information only, or also Make changes, which covers creating links and Rooms, publishing, and deleting documents.
- Select Connect assistant.
The assistant then works only in that workspace, with the permissions you approved. Plan limits and access rules apply exactly as they do in the app.
Manage or disconnect an assistant
Open Workspace → Integrations → AI assistants (MCP) → Connected assistants to see the assistants you connected, when each one was connected, and when it expires. Select Disconnect to end its access right away. This list shows your own connections.
If your Business trial expires or your workspace moves to a lower plan, your assistants stop being able to use that workspace. You can still disconnect your existing assistants. Returning to Business lets an unexpired connection work again, unless you disconnected it.
Each connection belongs to the person who approved it and lasts up to 90 days. After that, the assistant asks you to sign in again. Removing HummingDeck in Claude or ChatGPT stops that app from using it; Disconnect in HummingDeck also ends its access on the HummingDeck side.
Disable MCP for the workspace
An owner or admin can open the MCP card and select Disable MCP to pause all assistants in the workspace. The card changes to Disabled. Existing connections stay listed so you can disconnect them. Select Enable MCP to allow eligible, unexpired connections to work again.
Troubleshooting
- MCP access is not enabled: open the MCP integration card and select Enable MCP. If the control shows a Business upgrade, check Billing for an active Business trial or Business subscription. Free, Starter, and Pro do not include MCP.
- Owner or admin access required: only workspace owners and admins can connect an assistant. Ask an owner to change your role, or to connect it themselves.
- Sign in with a verified email: verify your email address, then start the connection again from Claude or ChatGPT.
- Connection limit: each person can have up to 20 assistant connections in a workspace, including requests that are still waiting for approval. Disconnect one you no longer use.
- The connection request has expired: start again from Claude or ChatGPT.
- The assistant does not offer a newer feature: refresh or reconnect HummingDeck in Claude or ChatGPT so it loads the current list of actions.