tulipfarm docsConnect an integration
Install an MCP integration from the marketplace and connect it so agents can use its tools.
This guide installs Slack from the TulipFarm marketplace and connects it so agents can use its tools. The same steps apply to other integrations, although their credential fields differ.
Prerequisites
- TulipFarm is running and you are signed in
- You can create or configure the integration in its provider
Install from the marketplace
- Open Integrations in the sidebar, then select Marketplace.
- Select slack in the official marketplace list.
- Click Install 1 integration.
TulipFarm clones the official tulipfarm/integrations repository, reads the integration's
manifest.yml, and writes it into your soul repo under
soul/integrations/{name}/manifest.yml. No server starts yet; no credentials are needed.
You can also install from any GitHub repository. Click Add from URL, enter a GitHub
URL (owner/repo shorthand or a full HTTPS URL), and TulipFarm will scan it for
integrations.
After installation, follow connect them now or open the Installed tab. Slack appears as disconnected.
Connect the integration
- Open slack from the Installed tab.
- Open Setup guide for the provider-side setup. Each field also has a How to get this section.
- Fill in the shared fields, then choose Connect with OAuth or Paste token directly.
- Click the connect button for your chosen method.
TulipFarm starts the integration's MCP server. The status changes to Connected.
TulipFarm encrypts fields that the integration marks as secret, including OAuth access tokens
and client secrets, in the Secrets store. The soul keeps an opaque secret:// reference instead
of the plaintext value. Non-secret connection settings remain in the soul.
Verify the connection
The detail page should show Connected. Then ask the assistant to use the integration:
List the channels available in Slack.
The assistant should return channels from your workspace. If it cannot use a Slack tool, see Troubleshooting.
Disconnect
Open the integration's detail page and click Disconnect. TulipFarm stops the MCP server and removes its tools from the tool registry. The soul entry is preserved — you can reconnect without reinstalling.
Remove the integration
Click Remove integration on the detail page and confirm. TulipFarm disconnects the server, removes the integration from the soul, and deletes its stored integration secrets.
Troubleshooting
Status shows "Error" — the MCP server failed to start or exited unexpectedly. Open the integration, check its credentials, then connect again. The error appears beside the status.
The assistant cannot use the integration's tools — check the Installed tab. If the integration is disconnected, open it and connect again.
Marketplace is empty or cannot load — TulipFarm clones from GitHub to browse the marketplace. Check that the host running TulipFarm has outbound internet access.