flff

Connect your AI app

Every app needs the same thing: this server address, and your flff email and password the first time.

https://mcp.flff.fi/mcp
Choose your app

Claude (claude.ai and the desktop app)

  1. Open Settings → Connectors and choose Add custom connector.
  2. Give it a name, for example flff, and paste https://mcp.flff.fi/mcp as the URL. Leave the advanced settings empty.
  3. Click Connect. A flff sign-in page opens: sign in with your flff email and password.
  4. On the next page, review what Claude may do and click Allow. Leave "Allow changes to files" ticked if you want Claude to edit your site.
  5. In a new chat, make sure the flff connector is switched on in the chat's tools menu, then ask: "List my flff sites."

ChatGPT

Custom connectors need a paid ChatGPT plan with developer mode. Menu names change from time to time.

  1. Open Settings → Apps & Connectors, go to the advanced settings and turn on Developer mode.
  2. Create a connector with the URL https://mcp.flff.fi/mcp and authentication OAuth.
  3. Sign in on the flff page that opens, then click Allow.
  4. Turn the connector on in a chat and ask: "List my flff sites."

Claude Code

Run this in your terminal:

claude mcp add --transport http flff https://mcp.flff.fi/mcp

Then start Claude Code, type /mcp, choose flff and Authenticate. Your browser opens the flff sign-in page.

Apps that run AI on your computer

Many local apps, such as Locally Uncensored, can only start MCP servers as a command rather than connect to an address. A small bridge called mcp-remote fills the gap: it runs on your computer, handles the sign-in, and passes everything on to flff.

  1. Install Node.js (version 18 or newer) if you don't have it.
  2. Sign in once from a terminal. Local apps give up if the sign-in takes too long, so do it here first:
    npx -y mcp-remote https://mcp.flff.fi/mcp
    Your browser opens the flff sign-in page. Sign in, click Allow, and close the terminal when it says it's connected. Your login is saved on your computer.
  3. Add the server in your app: command npx, arguments -y mcp-remote https://mcp.flff.fi/mcp.

Locally Uncensored, step by step

  1. Settings → Agent → MCP Servers: add the server as above, then click Connect. Check that it lists the flff tools (list_sites, read_file, write_file and so on).
  2. Settings → Agent → Permissions: make sure the MCP row isn't set to Blocked. "Ask First" is fine: you'll approve each change.
  3. Open a new, empty chat and switch on Agent before your first message. If the Agent switch is greyed out, the model can't use tools: pick one marked as tool-capable in the Models tab.
  4. Ask: "Run the list_sites tool." Naming the tool makes sure the model sees it.
Reconnect after every restart. Locally Uncensored doesn't remember the connection: after restarting the app, click Connect on the flff server again before opening an agent chat. A chat that was opened earlier won't see the tools; start a new one.

Local models vary a lot in how well they use tools. If the model talks about changes instead of making them, try a larger model with tool calling.

What to ask once you're connected

The tools your AI gets:

ToolWhat it does
list_sitesLists the sites you can use, whether you can change them, and each site's web address
list_filesLists the files in a folder of a site
read_fileReads a file
write_fileCreates a file or replaces it completely; live immediately, and it tells your AI the page's address
make_directoryCreates a folder
moveMoves or renames a file or folder
deleteDeletes a file or folder
There's no undo yet. write_file replaces the whole file. Keep a copy of pages you like, or ask your AI to show you a file before rewriting it.

If something doesn't work

You seeWhat it means
"no bearer token" when you open the server address in a browserThat's expected: the address is for apps, not browsers. Your app adds the sign-in.
The AI says it has no flff toolsStart a new chat after connecting. In local apps, check the server is connected (see above) and Agent mode is on.
"This connection was not granted sites:write"You connected read-only. Disconnect the app, connect again, and leave "Allow changes to files" ticked.
A site isn't listedYour login hasn't been given access to it. Ask us.
"Request initialize timed out" in a local appDo the one-time sign-in from a terminal first (step 2 under local apps).

Still stuck? Tell us roughly when you tried and what you saw. We can follow the request on our side.