Skip to main content
Connic
Getting Started

Quickstart

Stand up your first Connic project, deploy an agent, and trigger a run from its connector.

Last updated
On this page
Want your coding agent to do the work?

Choose your coding client, install the Connic plugin when a native package is available, then tell the agent what you want to build. The same guide covers separate skill and MCP setup for other clients. Follow AI agent setup.

1

Create a Project in Connic

Create a new project in the Connic dashboard. The wizard will guide you through connecting your repository.

2

Set Up Your Local Project

Install the SDK, then either scaffold from a template or create a minimal project.

terminal
pip install connic-composer-sdk

Option A: Start from a template (recommended). Browse agent templates and run:

terminal
connic init my-project --templates=invoice,customer-support --skill
cd my-project

Option B: Start from scratch. Creates a minimal structure:

terminal
connic init my-agents --skill
cd my-agents

The optional --skill flag adds the Connic skill to the project. In an interactive terminal, the CLI also detects Codex and Claude Code and offers to install the full plugin, which bundles the skill and MCP. Decline the prompt to keep the skill-only setup. See AI agent setup.

3

Define Your Agent

Edit the agent YAML file to configure your agent.

agents/assistant.yaml
version: "1.0"

name: assistant
model: connic/gpt-5.6-terra
description: "A helpful assistant"
system_prompt: |
  You are a helpful assistant. Answer questions
  clearly and concisely.

temperature: 0.7
max_concurrent_runs: 1

Each YAML file in the agents/ folder defines one agent. You can have multiple agents in a single project. For simple projects, keep them at the top level; for larger projects, you can optionally organize agents into subfolders under agents/.

4

Deploy

Choose Git (auto-deploy on push) or CLI (works with any provider).

Git integration
  1. Connect your repo in Project Settings → Git & Environments
  2. Map each environment to a branch on the same page
  3. Push to trigger deployment
terminal
git add .
git commit -m "Initial agent setup"
git push origin main
CLI deploy
  1. Create API key in Project Settings → API Keys & MCP Auth
  2. Run connic login in your project folder
  3. connic dev to iterate, or connic deploy for production
terminal
connic login
connic deploy
5

Create a Connector

To trigger your agent, create a connector from the marketplace. For example, you can create an HTTP webhook to add an AI agent to your existing product through API calls.

a

Open your agent's detail page in the Agents section

b

Click the + button on the connector flow diagram, then choose Create New Connector

c

Pick a connector type from the marketplace and configure it (name, mode, etc.)

d

The connector is automatically linked to the agent once created

6

Trigger and Inspect Your Agent

Trigger your agent using the connector you created. For example, if you created an HTTP webhook connector, you can trigger it with a curl command:

terminal
curl -X POST <webhook-url> \
  -H "Content-Type: application/json" \
  -H "X-Connic-Secret: <your-secret-key>" \
  -d '{"message": "Hello, agent!"}'

Check the Runs section in your project to see the agent's response and trace details.

You're all set!

Your agent is now deployed and ready to use.

Keep building

Project Structure

Understand how Connic Composer SDK works

Agent Configuration

Configure LLM, Sequential, and Tool agents

Tools

Create Python functions your agents can call

Connectors

Integrate agents with external systems