# Circleci AI connector guide

Connect Circleci data to AI agents with Combined. Explore context, self ids, self collaborations, source setup, MCP access and read-only business queries.

Combined offers 1,125 connectors across catalog sources and connectors generated through desktop automation.

## Connect

1. Open Combined Connected Apps and select Circleci.
2. Authorize the source and choose the relevant datasets.
3. Complete a first sync, then grant your agent access through the Set up or Access workspace.
4. Discover the actual source schemas before querying.

## Setup reference

- API Key: required in the upstream source schema
- Job Number: optional
- Organization ID: required in the upstream source schema
- Project ID: required in the upstream source schema
- Start date: required in the upstream source schema
- Workflow ID: optional

## Dataset reference

- context; key: id; update field: created_at
- self_ids; key: id
- self_collaborations; key: id
- me; key: analytics_id; update field: created_at
- projects; key: vcs_url
- pipelines; key: id; update field: created_at
- specific_project; key: id
- jobs; key: number
- workflow; key: id; update field: created_at
- insights_metrics; key: project_id
- insights_branches; key: project_id
- workflow_jobs; key: id; update field: started_at

This is the upstream connector reference, version 0.1.0. Account permissions and sync configuration determine the datasets available in your workspace.

## Agent prompt

Use Combined to analyze my Circleci data.
List my granted sources, discover the datasets and describe their fields.
Look for datasets corresponding to context, self_ids, self_collaborations, me, projects, pipelines.
Check the last successful sync and report the available date coverage.
Propose three useful questions based on the fields actually available.
For the question I choose, run read-only SQL over the complete matching dataset.
Use a bounded result; include source names, time window and query receipt.
Ask for a missing join key or metric definition instead of inventing one.

## Links

- Combined: https://www.trycombined.com/
- Setup: https://www.trycombined.com/docs/getting-started/onboarding
- MCP: https://www.trycombined.com/docs/integrations/mcp
- Pricing: https://www.trycombined.com/pricing
- Upstream source reference: https://docs.airbyte.com/integrations/sources/circleci
- Full guide: https://www.trycombined.com/connectors/circleci