• SCALING
  • MONITORING
  • VISIBILITY
  • HUMAN

How to manage CI infrastructure with your AI

Connect Woodpecker to your AI client to handle agent scaling and health monitoring through chat.

Ask AI about this page

Short answer

Can I manage Woodpecker via chat?

Yes. You can spin up new agents, check server health, and monitor build metrics using your AI. This gives you a direct line to your CI infrastructure without touching the Woodpecker dashboard.

Infrastructure outcomes

What you get

The AI handles the repetitive management tasks so you can focus on code.

SCALING

Dynamic agent management

Your AI handles the heavy lifting of adding or removing agents. You get the capacity you need exactly when a build queue grows.

MONITORING

Real-time health checks

The AI pulls health and metric data instantly. You'll know if the system is struggling before a build fails.

VISIBILITY

Task tracking

Get a clear view of what agents are doing. Your AI lists active tasks so you can spot bottlenecks in your pipeline.

HUMAN

Manual oversight

The AI manages routine scaling and checks. You stay in control for complex configuration changes or deep debugging.

The workflow

What your AI does when <the thing arrives>.

The AI acts as a bridge between your chat interface and the Woodpecker API.

  1. Assess capacity

    The AI looks at your current agent pool and their active workloads to see if you need more power.

    list_agentslist_agent_tasks

  2. Scale up

    When you need more throughput, the AI provisions new agents to handle the load.

    create_agent

  3. Check health

    The AI verifies that the Woodpecker server and its agents are running correctly.

    get_healthzget_metrics

  4. Cleanup

    If an agent is stuck or no longer needed, the AI can remove it from the pool.

    delete_agentupdate_agent

Try it

Copy these to start.

Use these prompts to begin interacting with your CI.

Starting points

These are templates. Swap out the specific agent names or metric types to match your setup.

Woodpecker CI Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_FerYBzPY1px1PeVxdzIkY0bEgd6qWRE3xebiZbq6/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Woodpecker CI capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "woodpecker-ci-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_FerYBzPY1px1PeVxdzIkY0bEgd6qWRE3xebiZbq6/mcp"
    }
  }
}
Copy into chat04

  • List all my current Woodpecker agents and tell me if any are overloaded.

  • Check the health of my Woodpecker server and show me the latest metrics.

  • Create a new Woodpecker agent to help with the current build queue.

  • Show me the tasks currently running on the agent named 'build-worker-01'.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Woodpecker once, then ask.

Just link your Woodpecker instance to Vinkius. Your credentials stay encrypted, and you can immediately start managing your CI through your preferred AI client.

Connect Woodpecker to your AI

FAQ

How the Woodpecker management works

  • 01

    Can the AI delete my entire Woodpecker server?

    No. The AI only has tools to manage agents and check health. It cannot perform destructive actions on the core server installation.

  • 02

    Does the AI decide when to scale agents on its own?

    No. The AI only acts when you ask it to. It can suggest scaling based on metrics, but you must trigger the actual creation or deletion of agents.

  • 03

    Can I see specific build logs through the AI?

    No. The tools provided allow for monitoring agent tasks and health, but they do not include the ability to read individual build log files.

  • 04

    How does the AI know if an agent is busy?

    The AI uses the task listing tools to see what is currently running on each agent.

  • 05

    Can I update agent configurations?

    Yes, the AI can modify existing agent settings using the update tool.

  • More questions about Woodpecker? The Connector page answers them. See everything the Woodpecker Connector can do

Connect Woodpecker CI to Claude, Cursor, ChatGPT & more