# Getting Started with Personal Connectors

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


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:


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


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/personal-connectors",
    headers={"api-key": "YOUR_API_KEY"}
)

connectors = response.json()
print(connectors)
```


```javascript
const response = await fetch(
  'https://api.freddy.aitronos.com/v1/personal-connectors',
  {
    headers: {
      'api-key': 'YOUR_API_KEY'
    }
  }
);

const connectors = await response.json();
console.log(connectors);
```

**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](https://github.com/settings/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](https://app.clickup.com/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](https://id.atlassian.com/manage-profile/security/api-tokens)
2. Click "Create API token"
3. Copy the generated token


### Step 3: Create a Configuration

Configure the connector with your credentials:


```bash
curl https://api.freddy.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"
  }'
```


```python
import requests

response = requests.post(
    "https://api.freddy.aitronos.com/v1/personal-connectors/configurations",
    headers={
        "api-key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "connectorId": "github",
        "name": "My GitHub",
        "configuration": {
            "defaultRepo": "owner/repo"
        },
        "credentials": {
            "token": "ghp_your_github_token_here"
        },
        "description": "Personal GitHub integration"
    }
)

config = response.json()
print(f"Configuration created: {config['id']}")
```


```javascript
const response = await fetch(
  'https://api.freddy.aitronos.com/v1/personal-connectors/configurations',
  {
    method: 'POST',
    headers: {
      'api-key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      connectorId: 'github',
      name: 'My GitHub',
      configuration: {
        defaultRepo: 'owner/repo'
      },
      credentials: {
        token: 'ghp_your_github_token_here'
      },
      description: 'Personal GitHub integration'
    })
  }
);

const config = await response.json();
console.log(`Configuration created: ${config.id}`);
```

**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:


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


```python
response = requests.post(
    f"https://api.freddy.aitronos.com/v1/personal-connectors/configurations/{config_id}/test",
    headers={"api-key": "YOUR_API_KEY"}
)

health = response.json()
print(f"Status: {health['status']}")
```


```javascript
const response = await fetch(
  `https://api.freddy.aitronos.com/v1/personal-connectors/configurations/${configId}/test`,
  {
    method: 'POST',
    headers: {
      'api-key': 'YOUR_API_KEY'
    }
  }
);

const health = await response.json();
console.log(`Status: ${health.status}`);
```

### 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
```