Skip to main content

Connectors

Connectors are data sources that candidates can browse and search during an assessment. They simulate the kind of enterprise tools and knowledge bases that professionals use daily: email, project trackers, meeting notes, internal wikis, and enterprise search. Connectors are the in-assessment data sources, and are separate from ATS integrations, which connect Gradient to your hiring stack.

Connector categories

When adding connectors to an assessment, admins choose from categories. Each category has named variants so the connector appears branded to the candidate (e.g., “Gmail” instead of generic “Mail”). All built-in categories use the same keyword-ranking search backend (TF-IDF style). The variant name only affects what the candidate sees and the tool name the AI uses. Meeting Transcripts additionally supports participant and meeting-type filters.

MCP servers

Admins can also connect real Model Context Protocol servers. When adding an MCP Server connector, the admin provides a server URL, probes it to discover available tools, and adds it to the assessment. Candidates interact with MCP connectors the same way: the tools appear in their AI assistant automatically. MCP servers support optional authentication via static bearer tokens or OAuth flows.

How candidates use connectors

During the Explore phase, candidates get oriented and browse the available data sources. During the Task phase, they search those data sources through the AI assistant using natural language queries. See Candidates & Sessions for the phase model. The search returns relevant documents that the candidate can then reference in their deliverable.

Signal and noise

Each data source is tagged as either signal (relevant to the task) or noise (a distractor). This distinction is invisible to the candidate, who sees all data sources equally and must determine which ones are useful. The scoring engine tracks:
  • Which data sources the candidate connected
  • Which documents they searched for and reviewed
  • Whether they used signal documents in their deliverable
  • Whether they included noise data uncritically

Candidate permissions

Admins can control what candidates can do with connectors via the Candidate Permissions card in the assessment’s Data step. The two connector-related permissions are: These are two of the five candidate permissions; the rest govern skills, memory, and the agents.md configuration. See Assessments for the full set.
Connector data can be managed programmatically via the Connector Data API. Upload CSV, JSON, TXT, or Markdown files.