# Personal Connector Object

div
strong
🔨 In Development
 — This section is still being developed and may change.


Represents a personal connector definition that enables integration with external services through MCP (Model Context Protocol). Personal connectors can be official (externally hosted), Aitronos-built (hosted by Aitronos), or custom (user-provided MCP servers).

## Properties

**`id`** string

Unique identifier for the personal connector. Format: `pcon_` followed by alphanumeric characters.

**`object`** string

Object type identifier. Always `personal_connector`.

**`name`** string

Human-readable name for the connector. Examples: `"GitHub"`, `"ClickUp"`, `"Jira"`, `"Microsoft Teams"`.

**`type`** string

Connector type. Values:

- `official` - Externally hosted connector (e.g., GitHub, Figma)
- `aitronos_built` - Hosted and maintained by Aitronos (e.g., ClickUp, Jira, Teams)
- `custom` - User-provided MCP server


**`connectorId`** string

Unique identifier for the connector type. Examples: `github`, `clickup`, `jira`, `teams`, `custom_mcp`.

**`description`** string optional

Brief description of what the connector does and which service it integrates with.

**`iconUrl`** string optional

URL to the connector's icon image. Used for visual identification in UI.

**`category`** string optional

Connector category for organization. Values: `productivity`, `development`, `communication`, `design`, `custom`.

**`version`** string optional

Connector version. Format: semantic versioning (e.g., `1.0.0`).

**`status`** string

Connector availability status. Values:

- `active` - Connector is available for use
- `deprecated` - Connector is deprecated, use alternative
- `maintenance` - Temporarily unavailable for maintenance


**`serverUrl`** string optional

MCP server URL for official and custom connectors. Examples:

- `https://github-mcp.example.com` (official)
- `http://clickup-mcp:8000` (aitronos_built)
- `https://my-custom-server.com/mcp` (custom)


**`serverType`** string optional

MCP server communication protocol. Values: `http`, `websocket`, `stdio`.

**`metadata`** object optional

Additional metadata about the connector. Key-value pairs for custom attributes.

**`createdAt`** string

ISO 8601 timestamp when the connector was created.

**`updatedAt`** string

ISO 8601 timestamp when the connector was last updated.

**`createdBy`** string optional

User ID of the admin who added this connector (for custom connectors).

## Example Objects

### Official Connector (GitHub)


```json
{
  "id": "pcon_github",
  "object": "personal_connector",
  "name": "GitHub",
  "type": "official",
  "connectorId": "github",
  "description": "Official GitHub MCP Server for repository management and code operations",
  "iconUrl": "https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png",
  "category": "development",
  "version": "1.0.0",
  "status": "active",
  "serverUrl": "https://github-mcp.example.com",
  "serverType": "http",
  "metadata": {
    "supportedFeatures": ["repositories", "issues", "pull_requests"],
    "authMethod": "oauth2"
  },
  "createdAt": "2025-01-01T00:00:00Z",
  "updatedAt": "2025-01-01T00:00:00Z"
}
```

### Aitronos-Built Connector (ClickUp)


```json
{
  "id": "pcon_clickup",
  "object": "personal_connector",
  "name": "ClickUp",
  "type": "aitronos_built",
  "connectorId": "clickup",
  "description": "ClickUp task management integration",
  "iconUrl": "https://clickup.com/landing/images/logo-clickup_color.svg",
  "category": "productivity",
  "version": "1.0.0",
  "status": "active",
  "serverUrl": "http://clickup-mcp:8000",
  "serverType": "http",
  "metadata": {
    "supportedFeatures": ["tasks", "lists", "comments"],
    "authMethod": "api_key"
  },
  "createdAt": "2025-01-01T00:00:00Z",
  "updatedAt": "2025-01-01T00:00:00Z"
}
```

### Custom Connector


```json
{
  "id": "pcon_abc123",
  "object": "personal_connector",
  "name": "My Custom MCP Server",
  "type": "custom",
  "connectorId": "custom_mcp",
  "description": "Custom integration with internal tools",
  "category": "custom",
  "version": "1.0.0",
  "status": "active",
  "serverUrl": "https://my-company.com/mcp",
  "serverType": "http",
  "metadata": {
    "owner": "engineering-team"
  },
  "createdAt": "2025-01-01T00:00:00Z",
  "updatedAt": "2025-01-01T00:00:00Z",
  "createdBy": "user_xyz789"
}
```