Atelier201 websiteJoin the waitlist
ConnessioniSicurezza e autorizzazioni

Sicurezza e autorizzazioni

Cosa può modificare un agente, cosa spetta decidere solo al titolare e come limitarne i poteri.

Tre controlli, applicati in quest’ordine. L’autorizzazione effettiva di ogni richiesta è data dalla loro intersezione.

1. Gli ambiti della credenziale. Vengono scelti quando si approva la connessione. La schermata di consenso descrive ciascun ambito in una frase, che ne definisce il contratto: una funzionalità non descritta al momento del consenso non viene mai aggiunta in seguito a un ambito esistente.

2. Il limite per i membri dell’area di lavoro. Corrisponde al massimo che un membro non amministratore può delegare. Gli amministratori lo impostano in Strumenti per sviluppatori → Autorizzazioni. Si applica alle connessioni OAuth, che rappresentano l’identità di una persona, ma non alle chiavi API, che sono credenziali di servizio dell’area di lavoro non associate a una persona.

3. La deroga personale, se un amministratore ne ha impostata una per quella persona.

Cosa resta di competenza del titolare

Un agente non dovrebbe mai pubblicare un sito, collegare un dominio o modificare un piano senza un’istruzione esplicita del titolare. Il clic con cui il titolare rivendica un sito preparato e il consenso OAuth non costituiscono tale istruzione. Un link di anteprima mostra esattamente come apparirebbe il sito online, quindi condividilo prima.

La pubblicazione è inoltre vincolata a ciò che è stato esaminato: publish_site richiede il valore expected_generation restituito da review_publish e viene rifiutata se qualcosa è cambiato da allora.

Revoca

Qualsiasi connessione può essere revocata immediatamente da Strumenti per sviluppatori → Connessioni. Quando una persona viene rimossa dall’area di lavoro, vengono revocate automaticamente tutte le autorizzazioni che aveva delegato da lì.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Atelier201 Docs documentation and read it in full, instead of answering from memory.

https://atelier201.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://atelier201.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.