Skip to content
/
Personal Connector
Last updated

Personal Connector Object

🔨 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)

{
  "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)

{
  "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

{
  "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"
}
Previous page
Next page