Skip to content
/
Getting Started
Last updated

Getting Started with Personal Connectors

Personal Connectors allow you to integrate external services like GitHub, ClickUp, Jira, and more directly into your Freddy AI assistants. This guide will walk you through setting up your first personal connector.

What are Personal Connectors?

Personal Connectors are integrations that enable your AI assistants to interact with external services on your behalf. Once configured, your assistants can:

  • Create and manage tasks in ClickUp or Jira
  • Access and modify GitHub repositories
  • Send messages in Microsoft Teams
  • Connect to any custom MCP (Model Context Protocol) server

Quick Start

Step 1: Choose a Connector

First, see what connectors are available:

curl https://api.aitronos.com/v1/personal-connectors \
  -H "api-key: $FREDDY_API_KEY"

Available Connector Types:

  • Official - Externally hosted (GitHub, Figma Local)
  • Aitronos-Built - Hosted by Aitronos (ClickUp, Jira, Microsoft Teams)
  • Custom - Your own MCP server

Step 2: Get Your Service Credentials

Before configuring a connector, obtain the necessary credentials from the service:

For GitHub:

  1. Go to GitHub Settings → Developer Settings → Personal Access Tokens
  2. Click "Generate new token (classic)"
  3. Select scopes: repo, read:org, workflow
  4. Copy the generated token (starts with ghp_)

For ClickUp:

  1. Go to ClickUp Settings → Apps
  2. Click "Generate" under API Token
  3. Copy your API token (starts with pk_)

For Jira:

  1. Go to Atlassian Account Settings → Security → API tokens
  2. Click "Create API token"
  3. Copy the generated token

Step 3: Create a Configuration

Configure the connector with your credentials:

curl https://api.aitronos.com/v1/personal-connectors/configurations \
  -H "api-key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connectorId": "github",
    "name": "My GitHub",
    "configuration": {
      "defaultRepo": "owner/repo"
    },
    "credentials": {
      "token": "ghp_your_github_token_here"
    },
    "description": "Personal GitHub integration"
  }'

Important: Your credentials are automatically validated when you create the configuration. If the credentials are invalid, you'll receive an error immediately.

Step 4: Verify the Connection

Test that your connector is working:

curl -X POST https://api.aitronos.com/v1/personal-connectors/configurations/{config_id}/test \
  -H "api-key: $FREDDY_API_KEY"

Step 5: Use with AI Assistants

Once configured, your personal connectors are automatically available to all your AI assistants. When you chat with an assistant, it can use your connectors to perform actions:

Example conversation:

You: Create a GitHub issue for the bug we just discussed
Previous page
Next page