How to Use the Codefresh MCP in Claude

Q: Can I trigger a Codefresh build from Claude Desktop?

Yes, you use the triggercodefreshbuild tool to start a new pipeline run. It works by sending the request directly to the API from your local environment.

Q: Does this MCP server show all my Codefresh builds in Claude Desktop?

Yes, calling listcodefreshbuilds pulls the recent history into the chat. You can filter these results or ask for summaries based on the status returned.

Q: How does Claude Desktop handle my Codefresh account profile?

The getmycodefreshprofile tool fetches your account details only when you explicitly trigger it. Your identity information is never stored or cached by the server between sessions.

Track your CI/CD pipelines and trigger builds directly inside Claude Desktop without leaving your chat window.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Codefresh MCP to Claude Desktop

Create your Vinkius account to connect Codefresh to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Codefresh with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage your Codefresh pipelines in Claude Desktop

Stop jumping between your browser and your chat client. This MCP server lets you pull pipeline configurations and monitor status updates straight from the Claude interface. You can use `list_codefresh_pipelines` to see what is currently active and `get_pipeline_configuration` to inspect the details of any specific workflow.

Run builds and check execution status

Trigger new deployments or test runs by calling `trigger_codefresh_build` while you are mid-conversation. It removes the friction of switching contexts just to kick off a task. Once the process starts, ask the AI to check `get_build_execution_details`. You get the exact progress report without opening a separate dashboard.

View cluster and environment data

See which delivery clusters are connected to your account by using `list_delivery_clusters`. It helps you keep track of your infrastructure state while working in Claude Desktop. You can also pull shared environment variables with `list_shared_contexts`. This ensures you have the right keys and secrets visible when discussing deployment logic.

Setup guide

Set up Codefresh MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Codefresh MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Codefresh MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under codefresh-mcp.

json

{
  "mcpServers": {
    "codefresh-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Codefresh. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Codefresh now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Codefresh MCP in Claude Desktop

Open your Claude Desktop config file and add the server settings under the mcpServers key. Once you save the file and restart the app, the tools become available via the hammer icon.

Yes, you use the trigger_codefresh_build tool to start a new pipeline run. It works by sending the request directly to the API from your local environment.

Your credentials and build logs stay within your local machine's memory during the session. We handle the connection through a secure pipe that does not expose your environment secrets to third parties.

Yes, calling list_codefresh_builds pulls the recent history into the chat. You can filter these results or ask for summaries based on the status returned.

The get_my_codefresh_profile tool fetches your account details only when you explicitly trigger it. Your identity information is never stored or cached by the server between sessions.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript