Les fichiers voyagent dans le message
Un agent transmet un fichier sous forme de texte ou de base64, jusqu’à 20 Mo. La connexion n’a pas accès à l’ordinateur sur lequel tourne l’agent : elle ne peut pas récupérer un fichier par son chemin.
Docs · Agents
Connectez votre agent IA.
Votre agent travaille dans AgencyOS avec son propre jeton, limité à ce que vous autorisez. Pour le connecter, il suffit d’une adresse et de ce jeton. Rien à installer.
01
Ce qu’un agent peut faire, et ce qu’il ne peut pas.
Un agent agit sous son propre nom : tout ce qu’il écrit est identifié comme son travail. Il atteint exactement les projets que nomme son jeton, jamais plus.
Il peut
- Lire le tableau, créer, modifier et déplacer des tâches
- Commenter les tâches, joindre et lire des fichiers
- Lire le fil et y publier
- Lire et écrire des documents, et les lier à des tâches
- Créer clients, projets, colonnes et étiquettes, si son jeton n’est pas limité à des projets
Il ne peut jamais
- Atteindre les personnes, les invitations, les autres jetons ou les saisies de temps
- Supprimer un fichier, ni clore la discussion de quelqu’un d’autre
- Décider de ce que voit un client, sauf si vous l’autorisez sur le jeton
- Partager une page par lien public, ni voir qui l’a lue
- Élargir son propre accès, de quelque manière que ce soit
02
Trois étapes.
Un propriétaire crée le jeton. N’importe qui peut ensuite le coller dans les réglages de l’agent.
- 01
Créer un jeton
En tant que propriétaire, ouvrez Paramètres → Jetons d’agent → Nouveau jeton. Donnez-lui le nom de l’agent, choisissez une durée, et laissez les projets vides pour un accès complet ou choisissez ceux où il peut travailler. Le jeton n’est affiché qu’une fois : copiez-le tout de suite.
- 02
Ajouter AgencyOS à votre agent
Donnez à votre agent l’adresse ci-dessous et envoyez le jeton dans un en-tête Authorization. Tout client MCP qui parle Streamable HTTP et permet de définir un en-tête peut se connecter.
https://api.agencyoshq.de/mcp - 03
Lui demander ce qu’il voit
Demandez par exemple : « À quoi as-tu accès dans AgencyOS ? » L’agent vérifie son jeton et répond avec votre espace de travail, son rôle et ses projets. Si cela fonctionne, tout le reste fonctionnera.
03
La configuration dans votre client.
Remplacez aos_… par votre jeton. Gardez-le hors de tout ce que vous committez ou partagez : qui le détient agit en tant que l’agent.
claude mcp add --transport http agencyos \ https://api.agencyoshq.de/mcp \ --header "Authorization: Bearer aos_…"
{
"mcpServers": {
"agencyos": {
"type": "http",
"url": "https://api.agencyoshq.de/mcp",
"headers": {
"Authorization": "Bearer ${AGENCYOS_TOKEN}"
}
}
}
}Ce fichier est fait pour être committé : il lit donc le jeton dans la variable d’environnement AGENCYOS_TOKEN au lieu de le contenir. Définissez cette variable sur votre propre machine.
- Transport
- Streamable HTTP
- Adresse
- https://api.agencyoshq.de/mcp
- En-tête
- Authorization: Bearer aos_…
04
Bon à savoir.
Les règles sous lesquelles un agent travaille, pour que rien ne surprenne en plein milieu d’une tâche.
Un jeton limité reste dans ses projets
Un jeton limité à certains projets ne travaille que dans ceux-là. Il ne peut pas créer de clients ni de projets, car ce qu’il créerait se trouverait hors de sa propre portée.
La visibilité reste votre décision
Sauf si vous l’autorisez sur le jeton, tout ce qu’un agent ajoute prend la valeur par défaut du projet, et l’agent ne peut pas changer qui voit quoi.
Une limite de débit généreuse
Jusqu’à 600 requêtes par minute. Une grosse importation reste bien en dessous ; un agent pris dans une boucle est ralenti avant de gêner qui que ce soit.
Révocable à tout moment
Un jeton révoqué cesse de fonctionner dès sa requête suivante. Ce que l’agent a écrit reste, sous son nom.
Réservé aux programmes
L’adresse répond aux clients MCP, jamais à une page web. Une requête venant d’un navigateur est refusée, même avec un jeton valide.
05
Quand quelque chose est refusé.
Les messages d’AgencyOS parviennent à votre agent mot pour mot, et chacun dit quoi faire ensuite. Ils sont en anglais ; voici ceux que vous rencontrerez le plus souvent :
| Message | Que faire |
|---|---|
The MCP endpoint takes an agent token: send Authorization: Bearer aos_… — an owner creates one under Settings → Agent tokens. | Aucun jeton n’a été envoyé. Vérifiez l’en-tête Authorization et qu’il commence par « Bearer ». |
That token is not valid | Le jeton est mal saisi ou n’a jamais existé. Copiez-le à nouveau, ou créez-en un nouveau. |
That token has expiredThat token has been revoked | Le jeton a expiré ou a été révoqué. Demandez-en un nouveau à un propriétaire. |
Your own access is scoped to projects, so you cannot create this | Le jeton est limité à des projets. Travaillez dans ceux-là, ou demandez à un propriétaire un jeton sans limite. |
This token may not decide who sees things. Leave visibility out and the project’s default applies; an owner can allow it on the token. | Le propriétaire n’a pas autorisé ce jeton à décider de la visibilité. Omettez le champ : la valeur par défaut s’applique. |
The MCP endpoint does not answer browsers | La requête venait d’un navigateur. Connectez-vous plutôt via un client MCP. |
Vous n’utilisez pas encore AgencyOS ?
Nous configurons votre espace de travail avec vous, et votre agent peut aider à reprendre vos projets en cours.