MCP Server Management

An MCP server is a server that lets external AI clients such as Codex and Claude Code call workspace features—files, search, team activity, and more—in a standardized way.

MCP server

Management happens in two stages. First, the admin defines the maximum scope allowed across the whole organization, and then each user configures narrower permissions on the keys they issue, within that scope.


1. Organization-Wide Feature Settings

Define the maximum allowed scope that applies to all external AI connections. Features not allowed here cannot be enabled by users on their individual keys either.

Allowed ToolDescriptionCount
Basic informationChecks the current location, time, and task approval status.3
Read filesViews folder and file contents.5
File/document searchFinds material by file name or document content.2
Team informationLooks up team conversations and activity history. Related content may be sent to the external AI provider.2
Change files/foldersCreates, edits, and moves files and folders.5
TrashMoves approved files to a recoverable trash. Folders are not supported.1

Each allowed tool consists of the following detailed features (tools).

Basic Information

  • Check task approval status (getApprovalStatus): Checks whether a change task is allowed to proceed · a required tool for the approval flow
  • Check current location (getCurrentPath): Checks the currently viewed virtual folder location
  • Check current time (getCurrentTime): Checks the server's current date and time

Read Files

  • View folder contents (listResources): Checks the files and subfolders within a folder
  • Read file (readFile): Reads file contents or gets the download address for a large file
  • Read large text file (readTextFileRange): Reads a large text file in parts
  • View favorites (listFavoriteResources): Checks documents registered as favorites
  • View recent documents (listRecentResources): Checks recently opened documents

File/Document Search

  • Find files (internalFindFiles): Finds files by name or file type
  • Search document content (internalSearchContent): Quickly searches for content within documents

Team Information

  • Search team conversations (searchChat): Finds content within team conversations you can view
  • Check team activity history (getAuditLogs): Checks the task history of teams you can view

Change Files/Folders

  • Apply a partial text edit (applyPatch): Edits only the necessary parts of text so it doesn't conflict with other changes
  • Create folder (createFolder): Creates a new folder
  • Create file (createFile): Creates a new file
  • Update file content (updateFile): Edits the content of an existing file
  • Move file/folder (moveFile): Moves the location of a file or folder

Trash

  • Move file to trash: Moves a file to trash after approval

You can adjust all tools at once with Select All/Deselect All, or configure them individually per tool. After configuring, click the Save button.

2. Per-User External AI Connection Keys

Each user can issue keys for specific purposes within the scope allowed by the organization, and can further restrict which tasks and spaces each key can access. Click Issue Key under My External AI Connection Keys.

When issuing a key, you can configure the following.

ItemDescription
Expiration dateSpecifies the period during which this key is valid.
Allowed task scopeNarrows down which of the organization's allowed tools this key can actually use.
SpaceSpecifies the team folder or personal folder this key can access.
PathSpecifies the folder path allowed for access.

Once a key is issued, the MCP endpoint and CLI setup command are provided together.

MCP endpoint: https://[your address].setfn.me/api/mcp

First, set the issued key as the SETFN_MCP_TOKEN environment variable, then register it using the command appropriate for the client you're using.

# Codex CLI
codex mcp add setfn --url "https://[your address].setfn.me/api/mcp" --bearer-token-env-var SETFN_MCP_TOKEN
# Claude Code
claude mcp add --transport http setfn "https://[your address].setfn.me/api/mcp" --header "Authorization: Bearer $SETFN_MCP_TOKEN"

You can use the Copy CLI Setup button to copy the above configuration as-is. Once registered this way, whether it's Codex or another MCP client, it can immediately call workspace features within the permission scope of the issued key.

Even after issuing a key, you can rotate or revoke it at any time.

ActionMeaning
RotateInvalidates the existing key and issues a new key with the same configuration (permissions, space, path). This is a safe way to replace a key that may have been exposed, without breaking the integration.
RevokeImmediately invalidates the key. No further requests can be authenticated with this key.

When you rotate a key, you must also update the SETFN_MCP_TOKEN value and the key registered with the client to the newly issued value.

Security Precautions

  • We recommend not exposing the MCP endpoint directly to the outside. If external integration is required, apply HTTPS, authentication tokens, IP restrictions, and permission scope limits, and restrict callable tools to only the necessary scope.
  • In particular, it is safer to use MCP servers connected to high-impact tools—such as file access, code execution, sending email, or running workflows—only from an internal network or a trusted network.