Skip to main content

ZConnect keys

This page is for organization admins. It explains what a ZConnect key is, who can create one, and how to hand it to the people who will use it. If you just received a key and want to use it in Office, see Connect Claude in Microsoft 365 with Zeldoc.ai instead.

What a ZConnect key is​

ZConnect is an add-on to ZRouter that brings approved frontier models into Microsoft 365 and other business tools. A ZConnect key is a Zeldoc.ai API key that is fixed to the ZConnect models: Zeldoc.ai chooses the set platform-wide, and every ZConnect key can call exactly that set, nothing more. Integrations such as the Claude add-in list the models a key can use, so only the approved models show up.

Apart from the fixed model list, a ZConnect key is an ordinary key on your organization. Its usage counts towards your organization's usage and billing, your rate limit applies, and it appears with your other keys on the API Keys page.

Where your data goes with ZConnect

ZConnect routes requests to external frontier models hosted outside the EU. Prompts and responses leave Zeldoc.ai's EU infrastructure at inference time and are processed by the model provider under its own data retention terms. This differs from ZDev and ZCore, where models never leave Zeldoc.ai infrastructure.

Who can create ZConnect keys​

The ZConnect page in the Zeldoc.ai dashboard is only shown to organization admins of an organization that has ZConnect. Viewers don't see it, and organizations without the add-on get "Access Denied". If you think your organization should have ZConnect, contact the Zeldoc.ai team.

Create a key​

  1. Sign in to the Zeldoc.ai dashboard as an organization admin.
  2. Open ZConnect in the sidebar.
  3. The Models card lists the models every ZConnect key is fixed to. If it says no ZConnect models are configured yet, contact Zeldoc.ai; keys can't be created until the set is chosen.
  4. Under Create ZConnect key, name the key after the integration or team it is for, for example PowerPoint - Sales, and select Create key.
  5. Copy the key from the dialog. It is shown once; after you close the dialog it can never be displayed again.

The key now appears under Your ZConnect keys. To rename or delete it later, use the API Keys page.

Hand the key to the user​

The person who will use the key usually has no dashboard account, and an API key is not a dashboard login. Send them the key through a secure channel together with a link to Connect Claude in Microsoft 365 with Zeldoc.ai. That page has everything they need: the gateway URL and the steps in the add-in.

One key per integration or team

Create a separate key for each integration or team. If a key is ever leaked, delete just that key on the API Keys page without disrupting anyone else.

Keep keys safe

A ZConnect key spends your organization's budget. Treat it like a password: never post it in chat or commit it to version control.

Verify a key​

To check a key outside Office, list the models it can use:

curl https://api.zeldoc.ai/v1/models \
  -H "Authorization: Bearer $ZELDOC_API_KEY"

The response lists the ZConnect models. Any model from the rest of your organization's model list is not available through a ZConnect key; that is by design.