Connect Zilch to your AI
Connect your Zilch account to Claude, ChatGPT, GitHub Copilot or Gemini CLI, and ask about your products’ carbon footprints, compare products and add new ones, all from a chat.
What you need
- A Zilch account on the Team, Professional or Enterprise plan.
- Claude, ChatGPT, GitHub Copilot or Gemini CLI. The steps below cover all four.
- If your company manages that account (a Team or Enterprise plan), an admin may need to switch on connectors first. See Good to know below.
Step 1: Copy your Zilch secret key
- Log in to Zilch.
- Go to Settings, then Profile, then API Access.
- Find Secret API Key and copy it. It starts with
zlch_sk_. If there isn’t one yet, click Generate secret key.
Keep this key private, like a password. Anyone who has it can see and change your Zilch products.
If you already have a secret key, copy it instead of making a new one. A new key replaces the old one, and anything still using the old key stops working.
Step 2: Add Zilch to your AI assistant
Pick the one you use.
- Go to claude.ai and open Customize, then Connectors.
- Click + Add, then Add custom connector.
- Name: Zilch. URL: paste this, then click Continue.
https://api.tryzilch.com/mcp - Choose No sign-in.
- Under Request headers, add one header:
- Name:
x-api-key - Value: your secret key from Step 1
- Name:
- Click Add.
If you don’t see Request headers, see Troubleshooting below.
You need a paid ChatGPT plan: Plus, Pro, Business, Enterprise or Edu. On a Business, Enterprise or Edu workspace, an admin has to turn on Developer mode for everyone first.
- In ChatGPT, open Settings, then Apps & Connectors, then Advanced settings, and turn on Developer mode.
- Back in Apps & Connectors, click Create.
- Name: Zilch. URL: paste this:
https://api.tryzilch.com/mcp - For Authentication, choose Token and paste your secret key from Step 1. (It may be called Access token / API key.)
- Click Create. If ChatGPT asks you to confirm you trust the connector, confirm it.
This one means editing a file, so it suits your developer, or someone comfortable doing that.
- In your project, create the file
.vscode/mcp.json. - Paste this in, replacing
YOUR_SECRET_KEYwith your key from Step 1:json{ "servers": { "zilch": { "type": "http", "url": "https://api.tryzilch.com/mcp", "headers": { "Authorization": "Bearer YOUR_SECRET_KEY" } } } } - Save the file. Copilot picks it up on its own. If Zilch doesn’t show up, click Start just above
"zilch"in the file.
This one also means editing a file, so it suits your developer, or someone comfortable doing that.
- Open (or create)
~/.gemini/settings.json. - Paste this in, replacing
YOUR_SECRET_KEYwith your key from Step 1:If the file already has other settings, add thejson{ "mcpServers": { "zilch": { "httpUrl": "https://api.tryzilch.com/mcp", "headers": { "Authorization": "Bearer YOUR_SECRET_KEY" } } } }"mcpServers"section alongside them. - Save the file and restart Gemini CLI.
Step 3: Start chatting
- Claude: start a new chat, click + at the bottom left, then Connectors, and switch on Zilch.
- ChatGPT: start a new chat, click + in the message box, choose Developer mode, and switch on Zilch.
- GitHub Copilot: just start chatting in your editor. No extra switch needed.
- Gemini CLI: just start it and ask your question. No extra switch needed.
Your assistant should check with you before it adds or changes anything in your Zilch account. In Claude and ChatGPT, look for an approval step before each change goes through.
Things you can ask
- “What’s in my Zilch account?”
- “Which of my products have the lowest carbon footprint?”
- “Compare the carbon footprint of MUG-01 and MUG-02.”
- “Tell me everything about our bamboo travel mug.”
- “Add a new product: steel water bottle, 450 g, stainless steel, made in China, packed in a cardboard box.”
- “Estimate the carbon footprint of the products I just added.”
- “Email the carbon footprint report for 100 units of MUG-01 to jane@example.com.” This needs a paid plan, not a free trial.
Good to know
- Changes are real. Anything your assistant adds or changes happens in your Zilch account.
- AI estimates are drafts. Review and finalise them in Zilch before you share them. Your assistant gives you a link to each one.
- Your finalised footprints are safe. Your assistant can’t change a finalised footprint, and it can’t delete products.
- Emails need your go-ahead. Your assistant checks the customer’s email address with you before it sends a report.
- There are daily limits, for example 100 AI footprint estimates a day.
- A company account may need an admin first. On a Team or Enterprise plan for Claude or Copilot, or a Business, Enterprise or Edu workspace in ChatGPT, an admin sometimes has to switch on connectors before you can add Zilch.
- To disconnect, remove Zilch from your assistant’s connector or MCP settings (in Claude: Customize, then Connectors). To block access completely, generate a new secret key in Zilch.
Troubleshooting
| Problem | What to do |
|---|---|
| I can’t see Request headers in Claude | Claude is still rolling this option out to everyone. Email us at info@tryzilch.com and we’ll help you connect another way. |
| It says my plan doesn’t include this | Connecting needs the Team, Professional or Enterprise Zilch plan. You can upgrade in Zilch under Billing. |
| It says my key is invalid | Copy the key again from Zilch. Check it starts with zlch_sk_ and has no spaces before or after it. In a config file, keep Bearer and a space in front of the key. |
| It says it needs a secret key | You’ve used the widget key, which starts with zlch_live_. Use the Secret API Key instead. |
| It doesn’t use Zilch when I ask | Check Zilch is switched on for the chat (see Step 3). It also helps to mention Zilch in your question. |
