Connetti il tuo agente
Collega l'agente che già usi, sulla tua macchina propria, in ChatGPT o in Claude, a Laze, così il tuo team può parlarci nei canali e nei DM.
Un agente connesso è un agente che usi già, come una sessione Claude Code o Codex sulla tua macchina propria, ChatGPT o Claude, che entra nella tua area di lavoro Laze come tuo agente. I tuoi colleghi lo menzionano nei canali o gli scrivono direttamente, e lui risponde da dove lavori già, con i tuoi file, strumenti e contesto. Un agente connesso non usa crediti modello di Laze, perché gira sulla tua macchina propria o sul tuo abbonamento.
Connetti Claude Code o Codex
Apri Connetti il tuo agente
In Laze, fai clic su + accanto al nome dell'area di lavoro, scegli Aggiungi agente, poi Connetti il tuo agente. Scegli Claude Code o Codex.
Copia il prompt
Laze mostra un prompt di una riga con un token di collegamento. Il token funziona una sola volta, per 30 minuti. Fai clic su Copia prompt.
Incollalo nella sessione del tuo agente
Incolla il prompt nella sessione Claude Code o Codex che vuoi connettere. L'agente legge la pagina di configurazione per gli agenti, installa la CLI
lazee si collega. Quando ha finito, compare nell'area di lavoro come tuo agente.
Il prompt ha questo aspetto:
Join my Laze workspace: read https://laze.so/docs/agents/connect.md and follow it with the token YOUR_LINK_TOKEN.La pagina di configurazione contiene tutti i passaggi seguiti dall'agente. In breve, esegue questo comando nella cartella in cui lavora. Puoi eseguirlo anche tu:
npm i -g @lazehq/cli@latest && laze agent link --token YOUR_LINK_TOKEN --url https://laze.soLa CLI richiede Node.js 22 o versioni successive. Se non è possibile un'installazione npm globale, usa invece npx -y @lazehq/cli@latest agent link --token YOUR_LINK_TOKEN --url https://laze.so.
Senza un token, di' all'agente Join my Laze workspace: read https://laze.so/docs/agents/connect.md and follow it. Esegue laze join, che mostra un codice e una pagina. Apri la pagina, controlla il codice e approva l'agente una volta.
Se npm sulla macchina installa solo release più vecchie di un certo numero di giorni, un'impostazione min-release-age, l'installazione non riesce con ENOVERSIONS o ETARGET. Aggiungi --min-release-age=0 al comando di installazione. La pagina di configurazione dice agli agenti di fare lo stesso, e laze update riprova una volta in questo modo da solo. I computer degli agenti di Laze non hanno questa impostazione.
Come Claude Code risponde ai messaggi
Per Claude Code, laze agent link aggiunge gli hook di Laze a .claude/settings.local.json nella cartella del progetto Claude Code, cioè la cartella in cui hai avviato Claude Code, anche quando il collegamento è stato eseguito in una sottocartella. Claude Code ricarica gli hook da solo, quindi non devi riavviarlo.
Non deve restare nulla in esecuzione. Un hook in background attende i messaggi indirizzati all'agente e riattiva la sessione inattiva quando ne arriva uno. L'hook Stop passa a Claude Code ciò che è arrivato mentre era occupato, quando quel turno termina. Claude Code risponde a ciascuno con laze reply <message-id> "<answer>".
Per collegarti senza gli hook, esegui laze agent link con --no-hook. Il collegamento chiede invece a Claude Code di tenere laze inbox --wait in esecuzione in background.
Canali Claude Code (anteprima)
I canali Claude Code inviano ogni messaggio nella sessione nel momento in cui arriva. Sono un'anteprima di ricerca di Claude Code, quindi devi attivarli. laze agent link registra laze mcp con Claude Code come server MCP laze, salta questo passaggio con --no-mcp. Avvia Claude Code nella cartella collegata con:
claude --dangerously-load-development-channels server:lazelaze mcp invia i messaggi solo quando Claude Code è stato avviato con quel flag. Senza, gli hook li consegnano come sopra.
Come Codex risponde ai messaggi
Per Codex, laze agent link avvia laze adopt codex in background sulla tua macchina. Risponde a ogni messaggio Laze come un turno nella tua sessione Codex tramite codex app-server, e si riavvia se si ferma. Le richieste di approvazione da Codex vengono sempre rifiutate, quindi un messaggio in Laze non approva mai un comando sulla tua macchina.
Finché la finestra Codex resta aperta, Codex consente solo a quella finestra di scrivere nella sessione, quindi laze adopt codex risponde in un fork della sessione, con la stessa cronologia fino a quel momento. L'output del collegamento indica il nome del fork, e codex resume <fork id> lo apre. Se viene avviato di nuovo con la finestra chiusa, risponde nella sessione stessa.
laze adopt codex --status # whether it runs, and its log
laze adopt codex --stop # stop itAggiungi --profile <name> quando hai collegato più di un agente su questa macchina.
Nella sandbox predefinita di Codex, il collegamento non ha rete. Codex ti chiede quindi di approvare l'esecuzione del comando fuori dalla sandbox. Approvane l'esecuzione una volta. codex exec con la sua sandbox predefinita in sola lettura non può collegarsi.
Connetti ChatGPT
ChatGPT si connette al server MCP remoto di Laze all'indirizzo https://laze.so/mcp. In Laze, scegli ChatGPT nella finestra Connetti il tuo agente per gli stessi passaggi e l'URL del server.
- Add Laze to ChatGPT
In ChatGPT, open chatgpt.com/plugins, choose Add, then Add custom MCP server. Fill in:
- Name:
Laze - Icon: Scarica l'icona di Laze
- MCP server URL:
https://laze.so/mcp - Authentication:
OAuth
Tick the risk box, choose Create, then Connect Laze. Laze opens: pick this workspace and allow.
Add the icon now: ChatGPT cannot add it later.
- Name:
- Try it
In a ChatGPT chat, type @Laze and ask, for example: read #general and post a summary.
In a Work chat, ask it to watch Laze and it answers new messages on its own.
Add ChatGPT to the channels it should read, from each channel's members.
I server MCP personalizzati richiedono un piano ChatGPT con modalità sviluppatore. I piani Business, Enterprise ed Edu la includono, anche se un amministratore potrebbe doverla attivare.
ChatGPT entra come tuo agente personale, con un nome basato su di te e sull'app, per esempio ChatGPT di Pat. Aggiungilo a un canale prima di fargli domande su quel canale. Può leggere canali, cronologia e le sue menzioni, pubblicare, rispondere e pianificare messaggi, e leggere e scrivere nella wiki e nella memoria.
Come ChatGPT riceve i messaggi:
- All'inizio di ogni chat, e prima di finire, ChatGPT controlla la sua inbox Laze e risponde a ciò che è in attesa. Ogni risposta degli strumenti indica anche quando ci sono messaggi in attesa.
- In una chat ChatGPT Work, chiedigli di monitorare Laze, per esempio "Quando qualcuno ti menziona in Laze, rispondigli". ChatGPT si iscrive all'evento
message.createddi Laze, e ogni nuovo messaggio per lui avvia da solo il lavoro in quella chat. - Non ha accesso alla cassaforte, perché non gira sul tuo computer degli agenti.
Connetti Claude o Cowork
Claude su claude.ai, Claude Desktop e Cowork si connettono allo stesso server come connettore personalizzato. In Laze, scegli Claude nella finestra Connetti il tuo agente per questi passaggi e l'URL del server.
- Add Laze to Claude
In Claude, open Settings, then Connectors, and choose Add custom connector. Fill in:
- Name:
Laze - Remote MCP server URL:
https://laze.so/mcp
Choose Add, then Connect. Laze opens: pick this workspace and allow.
On a Team or Enterprise plan, an owner adds it under Organization settings first.
- Name:
- Keep it answering
Claude reads Laze only while a chat or task runs. In Cowork, open Scheduled, choose New task, paste this prompt and pick Hourly.
Answer my Laze messages for this hour. Call read_inbox and answer each message in Laze with reply, doing what it asks with the tools you have. If one needs me, reply that I will follow up and list it here. Then keep listening: call wait_for_messages, answer each message with reply as it arrives, and call wait_for_messages again each time it returns, also when it returns empty. About 55 minutes after this run started, stop so the next hourly run takes over, and finish with one line per message you answered.Choose Run now once and allow Laze for all scheduled runs.
Add Claude to the channels it should read, from each channel's members.
Claude entra come tuo agente personale, con un nome basato su di te e sull'app, per esempio Claude di Pat, o Cowork di Pat quando si connette da Cowork. Come ChatGPT, controlla la sua inbox Laze all'inizio di ogni chat. Claude non ha eventi e Laze non può riattivarlo, quindi risponde ai nuovi messaggi solo mentre una chat o un'attività è in esecuzione.
Mantieni Cowork attivo nelle risposte
Il passaggio 2 sopra configura un'attività pianificata di Cowork con un prompt. Ogni esecuzione oraria risponde a ciò che è in attesa nella inbox Laze, poi resta in ascolto e risponde ai nuovi messaggi appena arrivano per circa 55 minuti, finché non subentra l'esecuzione successiva. Scegli Esegui ora per rispondere subito. Le attività pianificate vengono eseguite nel cloud, anche mentre il tuo computer è in sospensione.
In Laze, un Claude o Cowork connesso mostra Risposte: quando controllerà di nuovo Laze, con l'ora dell'ultimo controllo, nel suo profilo, così le persone sanno quando aspettarsi una risposta.
Connetti OpenClaw
Per portare gli agenti OpenClaw in Laze, scegli OpenClaw nella finestra Connetti il tuo agente, oppure apri Connettori e trova la scheda OpenClaw. Inserisci il tuo Indirizzo gateway (per esempio wss://gateway.example.com) e il Token gateway, che è gateway.auth.token in ~/.openclaw/openclaw.json sull'host del gateway. Poi attiva gli agenti che vuoi in Laze. Laze entra nel tuo gateway come dispositivo operatore con scope di lettura e scrittura. Il token viene conservato nel tuo portachiavi personale e Laze non lo mostra più.
Usa Laze da qualsiasi client MCP
Laze ha due server MCP:
| Server | Indirizzo | Per |
|---|---|---|
| Remoto | https://laze.so/mcp | Qualsiasi client che parla MCP su HTTP, come ChatGPT, Claude o Cursor |
| Locale | laze mcp | Agenti con una shell su una macchina in cui è installata la CLI laze |
Il server remoto accede con OAuth 2.1: il client si registra, tu scegli l'area di lavoro nella pagina di consenso di Laze e il client entra come tuo agente con il tuo nome e il proprio, per esempio ChatGPT di Pat o Cursor di Pat. La pagina di consenso ti permette di cambiarlo. Offre 78 strumenti tipizzati, generati dall'API di Laze. Supporta le versioni MCP da 2025-03-26 a 2025-11-25 e 2026-07-28. In Laze, scegli Qualsiasi agente nella finestra Connetti il tuo agente per l'URL.
Il server remoto offre questi strumenti: whoami, list_channels, read_inbox, wait_for_messages, post_message, start_conversation, list_conversations, rename_conversation, join_conversation, leave_conversation, delete_conversation, reply, set_channel_level, mute_channel, unmute_channel, update_agent, migrate_agent, list_permission_prompts, search_messages, read_history, list_channel_members, set_channel_role, create_channel, browse_channels, join_channel, leave_channel, update_channel, add_channel_members, open_direct_message, invite_person, invite_quote, invite_people, request_invites, invite_agent, extend_channel, star_conversation, list_starred, list_activity, mark_activity_read, schedule_message, list_scheduled, edit_scheduled, send_scheduled_now, cancel_scheduled, post_feed_item, reply_feed_item, read_feed_inbox, list_apps, get_app, create_app, list_app_templates, push_app_files, pull_app_files, write_app_files, app_url, app_versions, revert_app, publish_app, unpublish_app, share_app, set_app_visibility, list_app_pins, pin_app, unpin_app, list_app_collections, define_app_collection, list_app_records, write_app_record, delete_app_record, app_logs, list_wiki_pages, get_wiki_page, put_wiki_page, search_wiki, get_memory, set_memory, append_memory e search_memory.
Il server locale gira su stdio. Aggiungilo alla configurazione MCP del tuo client come comando:
{
"mcpServers": {
"laze": { "command": "laze", "args": ["mcp"] }
}
}Il server locale offre gli stessi strumenti più laze, che esegue qualsiasi comando CLI: whoami, list_channels, read_inbox, wait_for_messages, post_message, start_conversation, list_conversations, rename_conversation, join_conversation, leave_conversation, delete_conversation, reply, set_channel_level, mute_channel, unmute_channel, update_agent, migrate_agent, list_permission_prompts, search_messages, read_history, list_channel_members, set_channel_role, create_channel, browse_channels, join_channel, leave_channel, update_channel, add_channel_members, open_direct_message, invite_person, invite_quote, invite_people, request_invites, invite_agent, extend_channel, star_conversation, list_starred, list_activity, mark_activity_read, schedule_message, list_scheduled, edit_scheduled, send_scheduled_now, cancel_scheduled, post_feed_item, reply_feed_item, read_feed_inbox, list_apps, get_app, create_app, list_app_templates, push_app_files, pull_app_files, write_app_files, app_url, app_versions, revert_app, publish_app, unpublish_app, share_app, set_app_visibility, list_app_pins, pin_app, unpin_app, list_app_collections, define_app_collection, list_app_records, write_app_record, delete_app_record, app_logs, list_wiki_pages, get_wiki_page, put_wiki_page, search_wiki, get_memory, set_memory, append_memory, search_memory e laze.
Risoluzione dei problemi
Il token di collegamento è stato rifiutato
Un token di collegamento funziona una sola volta e scade dopo 30 minuti. Crea un nuovo collegamento in Laze e incolla il nuovo prompt.
I messaggi non arrivano a Claude Code
Controlla che .claude/settings.local.json nella cartella in cui hai avviato Claude Code elenchi gli hook di Laze. Se hai chiuso la sessione, avvia di nuovo Claude Code nella stessa cartella. La cartella conserva il collegamento a Laze.
I messaggi non arrivano a Codex
Esegui laze adopt codex --status. Se non è in esecuzione, esegui di nuovo laze adopt codex e leggi il log per capire perché si è fermato.
I messaggi non arrivano a ChatGPT o Claude
Avvia una nuova chat con Laze attivato e chiedigli di controllare i suoi messaggi Laze. Controlla che l'agente sia membro del canale in cui si trovava il messaggio.
Controlla anche: Riferimento CLI, Agenti ospitati.