Fenerum MCP Server (invite-only alpha)

Fenerum exposes an MCP (Model Context Protocol) server so AI clients such as Claude, ChatGPT, Claude Code, and Cursor can read and act on your Fenerum data. OAuth connections use your own Fenerum permissions; organization API tokens grant full organization access.

Endpoint: https://app.fenerum.com/api/mcp

Before you start

• Your organization must have MCP access enabled as part of the invite-only alpha. This is required for every connection method, including API tokens.
• For OAuth connections, you must be an active member of the invited organization and able to sign in to Fenerum.
• Your AI client must support Streamable HTTP and either OAuth or an authorization header. Legacy SSE transport is not supported by Fenerum.

Organizations without MCP access do not appear on the OAuth consent screen, and connection attempts are rejected. Contact Fenerum support if your invited organization is missing.

Connect Claude

Claude.ai and Claude Desktop

Use a custom connector with OAuth so each user acts with their own Fenerum permissions.

1. In Claude, go to Settings → Connectors → Add custom connector.
2. Enter https://app.fenerum.com/api/mcp.
3. Keep the detected settings at their defaults, as shown below, and click Add.
4. Click Connect, log in to Fenerum, choose the organization you want to grant access to, and click Allow.

Claude connector settings

Connect ChatGPT

Use ChatGPT on the web with Developer mode. Availability depends on your ChatGPT account and workspace policy; your workspace administrator may need to enable access.

1. In ChatGPT, open Settings → Security and login and turn on Developer mode.
2. Open ChatGPT Plugins, select +, and create a connection named Fenerum. Use a description such as “Read and manage Fenerum accounts, subscriptions, invoices, and reporting.”
3. Enter https://app.fenerum.com/api/mcp as the MCP server URL.
4. Choose OAuth with dynamic client registration (DCR). Leave the client ID and client secret blank for automatic registration. Do not choose CIMD, No Authentication, or Mixed Authentication. Use Streamable HTTP if a transport choice is shown.
5. Create the connection and complete Fenerum's login flow. Select your invited organization and click Allow.
6. Start a conversation, choose Developer mode from the + menu, and select Fenerum. Try a read-only request such as “Use Fenerum to show my organization's total MRR.”

ChatGPT supports read and write tools in Developer mode. Write actions require confirmation by default: review the proposed action and its inputs before approving it. Fenerum still checks the connection's granted permissions and your Fenerum role.

For current account availability and setup details, see OpenAI's Developer mode documentation and MCP connection guide.

Connect Claude Code and API-token clients

Use the same organization API token as the REST API. See Getting your API token for where to create it.

Replace <your-api-token> with your organization's token:

claude mcp add --transport http fenerum https://app.fenerum.com/api/mcp \
  --header "Authorization: Token <your-api-token>"

For other clients that support custom headers, use the same endpoint with Authorization: Token <your-api-token> and Streamable HTTP.

Clients using mcp-remote

For clients that support neither custom headers nor OAuth but can launch a local MCP process, use mcp-remote. This requires Node.js and npx on your computer. Add the following to the client's MCP configuration:

{
  "mcpServers": {
    "fenerum": {
      "command": "npx",
      "args": ["mcp-remote", "https://app.fenerum.com/api/mcp", "--header", "Authorization: Token <your-api-token>"]
    }
  }
}

This configuration contains your token, so keep it private. It is for clients that launch local MCP processes, not the ChatGPT web connection described above.

What you can do

MCP tools mirror the Fenerum REST API, including its results, filters, and validation:

Lists support the API's filters, sorting, and paging, with 25 results by default and 100 maximum. See the API reference for resource details.

Access and sessions

For OAuth connections in Claude and ChatGPT:

• Access is granted per user and per organization: the organization chosen on the consent screen. To use a different organization, connect again and select it.
• The permissions are read (view data) and write (create and change data). Tools that change data require write access, and your Fenerum role must permit the action.
• Sessions refresh automatically. A connection stays valid for up to 90 days of inactivity, after which you must sign in again.
• Actions appear in the audit log, attributed to you, with the client system MCP.

Organization API tokens use the token's organization access instead of these OAuth grants and sessions.

Troubleshooting

For help with the alpha or your organization's access, contact support@fenerum.com.