Using Eclarion with AI assistants

An AI assistant can read your specifications through the same API your integrations use. Give it our OpenAPI description and a key, and it can answer questions such as "which of our products may contain mustard?" from your own recipes, allergens and nutritional values.

What the assistant needs

  • The OpenAPI description, which tells it which requests exist and what comes back:
https://www.eclarion.com/api/v3/openapi.yaml
  • An API key, sent as a Bearer token. See below for which key to give it.

That is all. The description names every operation (getRecipes, getRecipe, getAllergens, getNutrients), so the assistant can pick the right one from your question.

Give the assistant its own read-only key

A key carries the role of its user. The key of an Editor or Admin can create, change and delete recipes. The key of a user with the role Viewer reads everything that user may see and cannot write: every create, update or delete is answered with 403 Forbidden.

So do not hand an assistant your own key. Give it a user of its own:

  1. In Eclarion, go to Account > Users and choose Invite user. Use an address you can open, and give the user the role Viewer.
  2. Sign in as that user and copy the key from Account > Profile, in the field API key.
  3. Give that key to the assistant.

An example

With an assistant that can run commands, such as Claude Code, the key goes in an environment variable and the rest is a question:

The OpenAPI description of our specification system is at
https://www.eclarion.com/api/v3/openapi.yaml
The key is in the environment variable ECLARION_API_KEY.

Which of our products may contain mustard? Give me name and code.

The assistant reads the description, looks up the allergen references and goes through your recipes:

curl https://api.eclarion.com/v3/allergens

curl -H "Authorization: Bearer $ECLARION_API_KEY" \
  "https://api.eclarion.com/v3/recipes?page=1&items=50"

Every recipe in the answer carries its allergens, where 0 is free from, 1 may contain, 2 contains and 3 unknown:

{
  "productname": { "nl": "Knoflookpoeder", "en": "Garlic powder" },
  "code": "SP-3010",
  "allergen_values": [
    { "reference": "mustard", "value": 1, "manual": false }
  ]
}

From there it answers in plain language. Follow-up questions work the same way: "give me the nutritional values per 100 g" or "what is the ingredient declaration in Dutch?"

Tested with

We tested this with Claude Code, with nothing but the description and a Viewer key (November 2026). It answered the questions above from the description alone, and its attempt to rename a product was refused.

An MCP connector is on our roadmap.

Next steps