MCP configuration

MCP (Model Context Protocol) lets NoteGen call external tools and resources through a standard protocol. Enabling MCP does not authorize every server automatically; enable a server and select it in the conversation.

Connection types

Local command (stdio)

Desktop only. Enter a command, space-separated arguments, and optional JSON environment variables:

{
  "API_KEY": "your-key"
}

You may enter a full launcher such as npx @modelcontextprotocol/server-filesystem in Command. When Arguments is empty, NoteGen separates the first word from the remaining arguments.

HTTP service

Available on desktop and mobile. Enter a service URL and optional JSON headers:

{
  "Authorization": "Bearer your-token"
}

Mobile cannot launch local stdio processes, so new mobile configurations offer HTTP only.

Add and import

• Add a server with its name, type, and connection parameters.
• Disable a server without deleting its configuration.
• Import JSON accepts common mcpServers structures and skips duplicates.
• Test a temporary configuration before saving. Enabled servers attempt to connect after save.

Runtime environment

Local commands often require Node.js, Python, uv, or another launcher. Check Environment shows detected versions and missing runtimes. On supported platforms, guided installation runs only after you confirm the command, displays logs, and can be cancelled.

Browse and use tools

The tool browser shows connected tools, descriptions, and parameters. In Chat or Agent, open MCP in the toolbar and select the servers for the current conversation. Tool calls still follow Agent approval rules.

Let another client access NoteGen

Desktop MCP settings include an Access NoteGen tab. When enabled, NoteGen runs a local Streamable HTTP MCP service on 127.0.0.1, allowing Claude Desktop, Codex, or another compatible client to work with the current workspace.

1. Open Access NoteGen and enable the service.
2. Keep the default port or select an unused port from 1024–65535.
3. Select Connect/Copy configuration. NoteGen generates JSON containing the local URL and a Bearer token.
4. Add the configuration to the other client and reload its MCP connections.

The service listens only on the local machine and uses port 37422 by default. Its token is a credential for the displayed workspace. Never paste it into a public conversation or issue. If exposure is possible, reset the access token and update every client.

After switching workspaces, verify the new scope shown in NoteGen before allowing an external client to continue write or delete operations.

Security

• Commands run programs with your user permissions; use trusted configurations only.
• Environment variables and headers may contain secrets. Do not share screenshots or exports containing them.
• Send remote MCP servers only the context needed for the task.
• Deleting a server does not revoke its third-party token.
• External Servers lets NoteGen call someone else's tools. Access NoteGen reverses that direction; treat their permission boundaries separately.