Agenti di programmazione IA

Sviluppi con Cursor, Claude Code, Windsurf o Codex? Dai al tuo agente un prompt, oppure una regola permanente, e marcherà per l’AI Act e la California ogni immagine, video e file audio generato dalla tua app. Legge la nostra documentazione come testo semplice.

In breve

Il prompt: qui sotto, pronto da incollare.
Skill e server MCP: per Claude Code, Codex, Cursor, Copilot e Gemini CLI: aggiungono le marcature ovunque la tua app crei contenuti multimediali con l’IA.
Documentazione per agenti: kennmarq.com/llms.txt (l’indice), llms-full.txt (tutta la documentazione), e qualsiasi pagina della documentazione in Markdown, al suo indirizzo più .md.
La chiave: una gratuita dalla dashboard, conservata in KENNMARQ_API_KEY sul server.
Verifica: trascina un risultato su kennmarq.com/check.

1. Ottieni una chiave

Registrati gratis, conferma la tua email e crea una chiave nella dashboard: una chiave di test mentre sviluppi, una di produzione quando vai in produzione. Mettila nell’ambiente del tuo server:

Shell

export KENNMARQ_API_KEY="sk_test_…"

2. Dai il prompt al tuo agente

Prompt

Mark every AI image, video and audio file this app generates with Kennmarq.com before it's stored or shown. The API docs are at https://kennmarq.com/llms.txt. Send each file to POST https://api.kennmarq.com/v1/mark with the key from the KENNMARQ_API_KEY environment variable, and pass provider, app_name, app_version, source and markets=eu,us-ca. For deep fakes, realistic depictions of real people, places or events, also send deepfake=true: it adds the visible "AI" label. Keep only the marked file.

3. Oppure rendilo una regola permanente

Una regola mantiene le marcature man mano che la tua app cresce: anche ogni nuova funzione che crea immagini, video o audio le riceve. Aggiungi questo ad AGENTS.md, che molti agenti di programmazione leggono, o a CLAUDE.md per Claude Code:

AGENTS.md

## AI content marking (Kennmarq.com)

- Every image, video or audio file this app generates with AI is marked before it's stored or shown: send it to POST https://api.kennmarq.com/v1/mark and keep only the file that comes back.
- Call the API from server code only, with the key in the KENNMARQ_API_KEY environment variable. The key never reaches a browser or a mobile app.
- Send provider (our legal name), app_name and app_version (this app), source (created, composite or edited) and markets with the ISO codes of the countries the app serves (eu, us, jp…; see https://kennmarq.com/docs/laws).
- Deep fakes (realistic depictions of real people, places or events) also get deepfake=true, which draws the visible "AI" label into the picture or every frame of the video. label=true adds it to any picture or video.
- If marking fails, the request fails: never show or store an unmarked file.
- Files over 4 MB, and every video, go up first through POST https://api.kennmarq.com/v1/uploads. Videos are marked as jobs: 202, then GET the mark's url until it's completed.
- Docs: https://kennmarq.com/llms.txt; all of them in one file: https://kennmarq.com/llms-full.txt.

Per Cursor, come regola di progetto in .cursor/rules/kennmarq.mdc:

.cursor/rules/kennmarq.mdc

---
description: Mark AI-generated images, video and audio with Kennmarq.com
alwaysApply: true
---

- Every image, video or audio file this app generates with AI is marked before it's stored or shown: send it to POST https://api.kennmarq.com/v1/mark and keep only the file that comes back.
- Call the API from server code only, with the key in the KENNMARQ_API_KEY environment variable. The key never reaches a browser or a mobile app.
- Send provider (our legal name), app_name and app_version (this app), source (created, composite or edited) and markets with the ISO codes of the countries the app serves (eu, us, jp…; see https://kennmarq.com/docs/laws).
- Deep fakes (realistic depictions of real people, places or events) also get deepfake=true, which draws the visible "AI" label into the picture or every frame of the video. label=true adds it to any picture or video.
- If marking fails, the request fails: never show or store an unmarked file.
- Files over 4 MB, and every video, go up first through POST https://api.kennmarq.com/v1/uploads. Videos are marked as jobs: 202, then GET the mark's url until it's completed.
- Docs: https://kennmarq.com/llms.txt; all of them in one file: https://kennmarq.com/llms-full.txt.

4. Oppure installa la skill e il server MCP

Il nostro kit per agenti contiene una skill, che il tuo agente carica ogni volta che un’app che sviluppa genera o modifica immagini, video o audio, con il codice per ogni stack: Vercel AI SDK, JavaScript, Python, ComfyUI e HTTP semplice. In Claude Code arriva come plugin, insieme al nostro server MCP:

Claude Code

/plugin marketplace add Kennmarq-com/kennmarq-agent-kit
/plugin install kennmarq@kennmarq

In qualsiasi agente che legge le skill (Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf e altri):

Shell

npx skills add Kennmarq-com/kennmarq-agent-kit

Il server MCP, all’indirizzo https://api.kennmarq.com/mcp, non richiede alcuna chiave. I suoi strumenti indicano cosa chiedono a un file le leggi sull’etichettatura di ogni mercato e cosa deve inviare una chiamata (get_requirements), forniscono il codice per uno stack (get_integration) e leggono qualsiasi pagina della documentazione (read_doc). Aggiungilo a Claude Code da solo, oppure a Cursor con un clic:

Shell

claude mcp add --transport http kennmarq https://api.kennmarq.com/mcp

Claude Code legge AGENTS.md solo quando il progetto non ha un CLAUDE.md: se c’è, metti la regola in CLAUDE.md, oppure aggiungigli la riga @AGENTS.md.

Cosa deve inviare il tuo agente

I campi che ogni chiamata invia
Campo	Cos’è
`provider`	La tua denominazione legale, in quanto fornitore del sistema di IA.
`app_name, app_version`	La tua app: il sistema di IA indicato nella dichiarazione latente della California.
`source`	created (creato dall’IA), edited (un file esistente modificato con l’IA) o composite.
`markets`	eu,us-ca, oppure i mercati in cui operi: una chiamata priva di quanto richiedono le loro leggi viene rifiutata, e ogni file riceve una ricevuta.
`model (facoltativo)`	Il nome del modello, ad es. FLUX.1 schnell.

5. Verifica cosa ha sviluppato

La chiave compare solo nel codice server: cerca KENNMARQ_API_KEY nel progetto, e verifica che non sia in nulla di ciò che carica un browser.
Ogni punto che crea un’immagine, un video o un brano chiama l’API prima di salvare o mostrare il file.
Quando la marcatura non riesce, non riesce nemmeno la richiesta: nessun file non marcato viene mostrato o salvato.
I file oltre i 4 MB e i video passano da un upload, e i video attendono il loro job (GET /v1/marks/{id}).
Un’immagine marcata trascinata sul verificatore mostra te come fornitore, il tuo sistema di IA e quando è stata creata.

Per il codice che un agente potrebbe scrivere, vedi le guide Next.js e Vercel AI SDK.