Direkt zum Inhalt

Synfire Pro MCP Connector

Autor andre

Note: This feature comes with the next update

The MCP connector of Synfire Pro is a powerful feature that allows any AI (e.g. Claude, ChatGPT, Gemini, or local models) to take control of Synfire and help you with routine tasks and creative roadblocks.

  • Projects: create, open, save and close arrangements, racks and libraries.
  • Structure: build and reorganize an arrangement’s containers (sections), including aliases, length, time signature, tempo changes, colors, and naming.
  • Instruments and sounds: add instruments and assign sounds. Search by name, category or articulation across your device descriptions.
  • Rack and plug-ins: set up rack modules with your installed AU/VST/VST3 instruments and effects. Load presets, recall saved plug-in states, and control volume, send, solo and mute.
  • Device descriptions: read, create and edit device descriptions for plug-ins and hardware, including sound banks, articulations and custom controllers.
  • Parameters: read, write and edit musical parameters such as harmony, rhythm, figure, dynamics, flow, velocity, take, tempo and expression. Use templates, copy, transpose, reverse and stretch.
  • Libraries: search phrase libraries by keyword or by similarity to an example. Drop phrases into your arrangement, or save your own.
  • Factories: generate new phrases with Synfire’s algorithmic Factories. Tune their settings and create variations of phrases you like.
  • Playback and listening: control the transport and preview parameters or note sequences. Read back the rendered MIDI output, or get a spectrogram so Claude can judge the sound.
  • Navigation and notes: jump to the relevant page or view in Synfire. Claude keeps notes per project and globally, so it can pick up where it left off.
  • Guide: a built-in guide covers workflows and the user manual.

This tutorial is a summary of how to set it up and get it running. Exploring what it can do – that's up to you. We haven't found many limits yet.

Comments

Do., 19.11.2026 - 16:14 Permalink

To start with the default briefings, open Preferences and enter the local IP address of your computer. 

Server

To protect against malware messing with your Synfire projects (extremely unlikely), you can set a random API key. Your MCP client (e.g. Claude Desktop) must send this in the X-API-Key HTTP header to authenticate. Most client apps allow this to be configured when you add a new MCP connector. Synfire uses HTTP without SSL (local connection only). Some clients may insist on HTTPS but there are workarounds. You may need to add the connector in some JSON configuration file. Ask your AI.

You can disable some groups of tools, like Projects or Images, to reduce complexity if you AI is not clever enough to use all 30+ Synfire tools at once. Or if you don't trust it to access your projects.

Phrase Database

Speaking of trust – you may also want your AI to see only parts of your work. On the Database tab, you can set a home directory it can access. You can add any paths relative to that that you want to exclude. On macOS  you also can use symbolic links to include selected folders on your machine outside the connector's base directory.


Similarity Search

When you re-index your files, Synfire builds a SQL database with all phrases it can find in the files under its base directory. This takes a while as every file must be opened and searched. Synfire uses this index to find potential replacements for phrases, or to suggest a phrase based on any Take you just recorded live.

How to Prepare Your Libraries

When it browses your libraries, the MCP connector only loads the header of each file. In order for the header to include useful meta-data, you need to once open and save every library with the latest version of Synfire that supports MCP.

Do., 19.11.2026 - 16:59 Permalink

Configuration

Configuration and customization is entirely done with markdown files. Use a Markdown editor like Typora, if you want to edit these files regularly. There's a new folder MCP under the usual Config folder.

The file briefing.md is your personal briefing for the AI. Tell it about your preferences, tastes, goals, and where it will find interesting material you want to use or reuse. Here's an example (yours should be different): 


The Notepad

Another interesting file is notepad.md. It includes the notes your AI jots down while it learns how to use Synfire. Have a look every now and then if you wonder why your AI behaves in an unusually clever way. It may have learned something new and written it down.

Instructions

You should not need to edit the other files unless there's something in them that repeatedly confuses your AI. We will fine-tune these instructions over time with the help of the Synfire community.

Do., 19.11.2026 - 18:12 Permalink

No. Only on a CASIO pocket calculator ;-) Should there be any issues on Windows we will fix them.

Do., 19.11.2026 - 18:32 Permalink

This server screen i don't see on my Synfire version ?
I do have the casio classpad ;-)
Give a answer on this, because your earlier answer is not helping

Fr., 20.11.2026 - 13:06 Permalink

Fantasic this new mcp feature for Synfire ai, i do have high expatations of it 🚀