Guide för MCP-klient

Anslut AlmRecorder till ChatGPT-appen och Codex

Lägg till AlmRecorder i OpenAI:s ChatGPT-app, Codex CLI eller Codex IDE-tillägg genom deras delade lokala konfiguration.

4 min läsningGranskad 2026-07-29
Obs: appens gränssnitt är för närvarande på engelska. Guiderna använder därför samma knappnamn som du ser i AlmRecorder.

Innan du börjar: kontrollera att AlmRecorder har Settings → MCP. Om den delen saknas installerar du en version med MCP-stöd.

Snabbaste vägen

Låt din agent göra installationen

Kopiera hela uppdraget, klistra in det i agenten och lägg AlmRecorders kopierade konfiguration längst ned. Hemlig token följer bara med när du själv klistrar in den.

Förhandsgranska instruktionerna
Konfigurera AlmRecorder som en lokal MCP-server för ChatGPT-appen eller Codex på denna Mac.

Arbeta försiktigt och gör installationen åt mig om du har fil- och terminalåtkomst. Om du inte kan redigera lokala filer ska du i stället ge mig den exakta färdiga filändringen och säga var den ska klistras in.

1. Kontrollera först att AlmRecorder visar Settings → MCP, att appen ligger på sin slutliga plats och är öppen.
2. Be mig aktivera Enable local MCP server, vänta på Listening on … och välja Copy configuration.
3. Jag klistrar in den kopierade JSON-konfigurationen längst ned i detta uppdrag. Be mig om den om den saknas.
4. Behandla ALMRECORDER_MCP_TOKEN som ett lösenord. Skriv aldrig ut den igen, logga den inte och lägg den inte i Git, ett supportärende eller en delad projektfil.
5. Redigera användarfilen ~/.codex/config.toml. Lägg till [mcp_servers.almrecorder] och [mcp_servers.almrecorder.env] utan att skriva över andra Codex-inställningar. ChatGPT-appen, Codex CLI och Codex IDE-tillägget delar denna fil på samma Codex-värd.
6. Använd exakt command, ALMRECORDER_MCP_SOCKET och ALMRECORDER_MCP_TOKEN från AlmRecorder. Transporten är lokal stdio och AlmRecorderMCPBridge har inga argument.
7. Ändra eller radera inga andra klientinställningar. Visa en diff eller beskriv exakt vad som ändrades.
8. Starta om den yta som används: Restart under Settings → MCP servers i ChatGPT-appen, Restart extension i IDE-tillägget eller en ny Codex CLI-session.
9. Be agenten anropa get_library_status och rapportera antalet inspelningar. Anropa sedan list_recordings med limit: 1. Ändra ingenting.
10. Aktivera inte AlmRecorders innehålls- eller skrivbehörigheter. Jag väljer dem själv efter att den skrivskyddade kontrollen fungerar.

ALMRECORDERS KOPIERADE KONFIGURATION:
[Klistra in Copy configuration från AlmRecorder här]

Förbered AlmRecorder

  1. Låt AlmRecorder.app ligga i Program och håll appen öppen.
  2. Öppna varje känslig inspelning och stäng av Allow MCP clients to access this recording. Använd Hide from MCP under Settings → Tags för privata kategorier.
  3. Låt både Allow content, notes, comments, summaries, and transcript search och Allow tags, notes, and comments to be changed vara avstängda under Settings → MCP. Aktivera Enable local MCP server och vänta på Listening on ….
  4. Välj Copy configuration. Du ska föra över kommando, socket och token till Codex TOML.
Hämta anslutningsuppgifterna

Token kopieras — den visas inte

AlmRecorder döljer avsiktligt den riktiga token i förhandsvisningen. Du ska alltså inte leta efter ett synligt tokenfält.

  1. Öppna Settings → MCP i AlmRecorder.
  2. Aktivera Enable local MCP server och vänta tills Status visar Listening on ….
  3. Välj Copy configuration. Urklippet innehåller nu kommando, socket och den riktiga ALMRECORDER_MCP_TOKEN.

Klistra konfigurationen direkt där guiden anger. Behandla den som ett lösenord och rensa urklippet när anslutningen fungerar.

Närbild av AlmRecorders MCP-inställningar med maskerad token, knappen Copy configuration och Rotate token. Välj Copy configuration
Den riktiga token följer med när du kopierarFörhandsvisningen är maskerad med flit. Copy configuration innehåller värdet som klienten behöver.

Behörighetsgräns: innehållsbehörigheten öppnar transkript, sökning, sammanfattningar, anteckningar och kommentarer. Ändringsbehörigheten öppnar taggändringar. Anteckningar och kommentarer kräver båda. Börja utan någon av dem.

Lägg till i OpenAI:s lokala klienter

Hur hänger de ihop? Codex är OpenAI:s kodningsagent. ChatGPT-appen innehåller nu både ChatGPT- och Codex-upplevelser. Appen, Codex CLI och Codex IDE-tillägget delar en MCP-konfiguration på samma Codex-värd; ChatGPT på webben läser inte den lokala filen.

Eftersom AlmRecorder behöver två miljövariabler är den delade TOML-filen den tillförlitliga installationsvägen; den grafiska sidan MCP servers är fortfarande användbar för att starta, stoppa och granska servern.

Öppna ~/.codex/config.toml. Lägg till tabellerna nedan—ersätt inte befintliga Codex-inställningar eller andra poster under mcp_servers.

[mcp_servers.almrecorder]
command = "/Applications/AlmRecorder.app/Contents/MacOS/AlmRecorderMCPBridge"

[mcp_servers.almrecorder.env]
ALMRECORDER_MCP_SOCKET = "/Users/du/Library/Application Support/AlmRecorder/MCP/mcp.sock"
ALMRECORDER_MCP_TOKEN = "klistra in token som kopierades från AlmRecorder"

Använd de tre exakta värdena från AlmRecorders kopierade JSON. Behåll TOML-citattecknen. Om appen ligger någon annanstans använder du det kopierade kommandot i stället för /Applications-exemplet.

Token lagras i klartext i filen. Behandla ~/.codex/config.toml som privat och klistra aldrig in den i ett projekt, supportärende eller en chatt.

Spara filen och starta sedan om klienten du använder:

  • ChatGPT-appen: öppna Settings → MCP servers, kontrollera almrecorder och välj Restart.
  • Codex IDE-tillägg: öppna kugghjulsmenyn, välj MCP servers och starta om tillägget.
  • Codex CLI: starta en ny session; codex mcp list ska visa almrecorder.

I appens skrivfält eller TUI visar /mcp de konfigurerade servrarna. Det bekräftar att konfigurationen hittades; nästa steg kontrollerar anslutningen till den öppna appen.

Kontrollera anslutningen

Be Codex:

Use AlmRecorder’s get_library_status tool and report the recording count. Then call list_recordings with limit: 1. Do not change anything.

Ett lyckat get_library_status bekräftar att bryggan når ditt öppna AlmRecorder-bibliotek. Aktivera först därefter innehållsbehörigheten för transkriptfrågor eller ändringsbehörigheten för godkända skrivningar.

Om det inte fungerar

  • Verktygen syns men anropet misslyckas: AlmRecorder är stängt, servern är av eller token/socket är inaktuella.
  • Bryggan hittas inte: flytta tillbaka AlmRecorder eller kopiera nya värden efter flytten.
  • Konfigurationsfel: kontrollera mcp_servers med understreck och att båda miljövärdena ligger under [mcp_servers.almrecorder.env].
  • Unauthorized: kopiera en ny token till alla klienter efter en rotation.

Ta bort de två almrecorder-tabellerna och starta om ytan du använder för att koppla från OpenAI:s lokala klienter. Stäng av MCP i AlmRecorder för att stoppa alla klienter direkt.

Codex dokumentation för MCP · Integritet i AlmRecorder · Allmän felsökning