Capítulos del curso
Formación · Curso 5. Equipos y administración · Capítulo 5.4 de 6
5.4 Tokens de API y conexión de Claude 2:39
Tokens de acceso personal, conexión de Claude con OAuth y revisión de lo que propone.
Muestra Holarch 1.7.
Lo que aprenderá
- Crear un token de acceso personal con acceso, proyectos y caducidad limitados
- Conectar Claude a Holarch iniciando sesión en la pantalla de consentimiento
- Revisar una propuesta de un cliente de IA y aplicar solo los cambios que quiera
- Revocar un token y desconectar una aplicación
Permita que los scripts y las herramientas de IA trabajen con sus proyectos de forma segura: cree un token de acceso personal con un alcance, unos proyectos y una caducidad; conecte Claude con OAuth en la pantalla de consentimiento; gestione las Aplicaciones conectadas; revise y aplique una propuesta de un cliente de IA; y el interruptor de API de la organización.
Archivos de proyecto
- Proyecto inicial (.holarch.json; Gestionar proyectos → Archivos de proyecto ▾ → Importar proyecto (.json)…)
El vídeo se reproduce desde holarch.app; consulte la Política de privacidad.
Práctica
Hágalo usted mismo en Holarch, en el proyecto de demostración CubeSat EO-1.
- Abra Ajustes de la cuenta → Tokens de API. En Nuevo token, llámelo
EO-1 report, elija Solo lectura, 30 días y Proyectos seleccionados con EO-1 marcado, y haga clic en Crear token; copie el token. - Ejecute el ejemplo de
curlde Token creado para listar sus proyectos y compruebe que solo se devuelve EO-1. - Haga clic en Conectar una aplicación de IA…, elija Claude y siga los pasos. En Conectar Claude a Holarch, elija Leer y proponer cambios, Proyectos elegidos con EO-1 y un final a los 30 días, y haga clic en Permitir.
- En Claude, pida:
Propose a test case in EO-1 that verifies requirement 2.4 Target Slew. - Abra EO-1, elija ✦ IA ▾ → Revisar “…”…, desmarque lo que no quiera y haga clic en Aplicar seleccionados.
- De vuelta en Tokens de API, haga clic en Revocar en
EO-1 reporty, en Aplicaciones conectadas, haga clic en Desconectar si no necesita tener Claude conectado.
Habrá terminado cuando EO-1 tenga el nuevo caso de prueba de la propuesta y el token ya no esté en su lista.
Compruebe lo aprendido
- ¿Cuándo se usa un token y cuándo una aplicación conectada?
- Es revisor en un proyecto y usa un token de lectura y escritura. ¿Puede un script cambiar ese proyecto?
- Claude propone cinco cambios. ¿Qué ha cambiado en el proyecto?
- ¿Cómo se cortan a la vez todos los tokens y aplicaciones?
Mostrar las respuestas
¿Cuándo se usa un token y cuándo una aplicación conectada?
Un token es para scripts y clientes que envían una cabecera fija; se muestra una sola vez y usted lo guarda. Una aplicación conectada inicia sesión en la pantalla de consentimiento de Holarch sin pegar un token, caduca como máximo al cabo de un año y aparece en Aplicaciones conectadas.
Es revisor en un proyecto y usa un token de lectura y escritura. ¿Puede un script cambiar ese proyecto?
No. Un token actúa como usted, dentro de su rol en cada proyecto, de modo que un revisor o un lector solo puede leer.
Claude propone cinco cambios. ¿Qué ha cambiado en el proyecto?
Nada todavía. Los cambios esperan como propuesta; usted los revisa, desmarca lo que no quiere y Aplicar seleccionados convierte el resto en un único paso de deshacer. Las eliminaciones y los cambios en elementos aprobados o incluidos en una línea base empiezan desmarcados.
¿Cómo se cortan a la vez todos los tokens y aplicaciones?
Cerrar sesión en todas partes, o restablecer la contraseña, desconecta todas las aplicaciones conectadas y revoca todos los tokens. Un administrador de la organización también puede desactivar el acceso por API y MCP para los proyectos de la organización.
Más información
Transcripción
Mostrar la transcripción (narración y lo que aparece en pantalla)
Introduction
Chapter four: API tokens and connecting Claude. Holarch has an API for scripts and reports, and an MCP endpoint that lets AI tools such as Claude work with your model.
Personal access tokens
Whatever connects, the same rules apply.
On screen: Rules card.
API tokens come with the Individual and Team plans. For a script, create a personal access token: in Account Settings, open AI and API, give the token a name, choose Read only, an expiry of ninety days, and create it.
On screen: API tokens → name → Read only → 90 days → Create Token.
The token is shown once. Copy it now, and store it where your script can read it. Holarch keeps only a fingerprint of it, and lists the token with when it was last used.
On screen: The new token; the list.
Connect Claude
To connect Claude, add Holarch as a connector in Claude's settings with the address app dot holarch dot app slash mcp, and click Connect. For this recording, a test client stands in for Claude, using the same steps.
On screen: Card: in Claude; then the consent screen.
Holarch opens its consent screen. It names the app and where it returns you, and you choose what it may do: read only, or read and propose changes; all your projects or chosen ones; and when it ends.
On screen: Consent screen.
Keep read and propose changes, and click Allow. Claude is now connected, and you get an email about it.
On screen: Allow.
Connected apps
Connected apps, in the same section, lists every app with its access, its projects and when it was last used. Disconnect cuts it off at once.
On screen: Account Settings → Connected apps.
Review a proposal
When Claude suggests changes to your model, nothing changes yet. They arrive as a proposal. Open the project: the AI menu shows the proposal waiting for review.
On screen: A proposal arrives; ✦ AI ▾.
Review it. You see each change, can edit it, and untick what you do not want. Apply Selected makes it one step you can undo.
On screen: Review → Apply Selected.
For the organization
An org admin can turn off API and AI-tool access for all of the organization's projects in Organization Settings. Tokens and connected apps then cannot reach them.
On screen: Organization Settings → API access.
Recap
Let's recap. Tokens are for scripts: scoped, limited to projects, and shown once. Claude connects with OAuth on a consent screen, appears under Connected apps, and its changes arrive as proposals you review.
Next, you set up AI for the organization.