ScreenJournal

Connecting AI Tools (MCP)

Screen Journal ships an MCP (Model Context Protocol) server, so AI assistants you already use — Claude, ChatGPT, or any MCP-enabled tool — can query your team's work record directly: what people worked on, where the hours went, and how something was done. Every answer is scoped to exactly what your role can already see in the dashboard, and no more.

Open MCP in the sidebar. The page has two tabs: Connect — pick your assistant and follow its setup steps — and Connected — see and manage what's already linked.

5.1 Your connection link

Every assistant needs the same thing: your ScreenJournal connection link. The Connect tab has a copy button next to it, whichever assistant you pick:

https://mcp-beta.screenjournal.ai/mcp

5.2 Connect from Claude

Set this up on a computer — it takes about a minute. Once connected, it works in the Claude mobile app too.

  1. Open claude.ai on a computer and sign in, then go to Settings → Connectors.
  2. Click Add custom connector.
  3. Paste your ScreenJournal connection link and click Add.
  4. Click Connect, and sign in to ScreenJournal when asked.

5.3 Connect from ChatGPT

Set this up on a computer. Requires a paid ChatGPT plan (Plus, Pro, Business, Enterprise or Edu).

  1. Open chatgpt.com on a computer and sign in.
  2. Turn on Developer mode.
  3. Open your plugins, then click the + icon in the top right of the page.
  4. Paste your ScreenJournal connection link as the MCP server URL, choose OAuth, and sign in to ScreenJournal when asked.

ChatGPT restricts connectors that can change data to Business, Enterprise and Edu plans. ScreenJournal is read-only, so any paid plan works.

5.4 Connect from any other assistant

ScreenJournal works with any AI assistant that supports remote MCP servers. Open your assistant's settings and look for wherever it lets you add a custom connector — assistants name this differently, so look for "connectors", "apps", "plugins", or "integrations". Paste in your ScreenJournal connection link and sign in to ScreenJournal when asked.

5.5 Claude Code (advanced, for developers)

If you use Claude Code from the command line, connect ScreenJournal there directly instead of through claude.ai:

  1. Add the server (--scope user makes it available in all your projects, not just the current folder):

    claude mcp add --transport http --scope user screenjournal https://mcp-beta.screenjournal.ai/mcp

  2. Start a fresh Claude Code session so it picks up the new server, then run /mcp, select screenjournal, and choose Authenticate. Sign in and approve in the browser that opens — your login is stored securely and refreshes automatically.

  3. Run /mcp again to confirm the server shows as connected, then chat normally — try "Using ScreenJournal MCP, what am I working on today?" and approve the tool the first time it's used.

5.6 Managing your connections

The Connected tab lists every assistant you've linked, whether it's actually been used, and a Disconnect button for each. Disconnecting an assistant stops its access to ScreenJournal within about 15 minutes.

5.7 Authorisation and permissions

Connecting opens Screen Journal's consent screen in your browser — sign in with your normal account and approve the client. Your account must belong to an organisation — ask your admin to invite you if it doesn't. Once connected, queries run under the same role permissions as the app: you can never see more through MCP than you can in Screen Journal itself.