### Verify pip installation

Source: https://help.dartai.com/en/articles/11199165-dart-in-terminal-and-python-integration

Check if the Python package installer is correctly installed on your system.

```bash
pip --version
```

--------------------------------

### Install Python on macOS and Linux

Source: https://help.dartai.com/en/articles/11199165-dart-in-terminal-and-python-integration

Platform-specific commands to install Python using system package managers.

```bash
# macOS (Homebrew)
brew install python

# Linux (Debian-based)
sudo apt update
sudo apt install python3 python3-pip
```

--------------------------------

### Install Dart Tools

Source: https://help.dartai.com/en/articles/11199165-dart-in-terminal-and-python-integration

Install the Dart CLI and Python library using the pip package manager.

```bash
pip install dart-tools
```

--------------------------------

### Dart Agent Workflow Configuration - Starting (n8n)

Source: https://help.dartai.com/en/articles/11657672-custom-ai-agents

This configuration is used to notify a Dart agent that a task has been started. It utilizes a webhook to send a simple 'I'm on it!' message along with the task ID.

```JSON
{
    "item": {
        "taskId": "{{ $json.body.task.id }}",
        "text": "I'm on it!"
    }
}
```

--------------------------------

### Add Dart MCP via Command Line Interface

Source: https://help.dartai.com/en/articles/10733406-dart-mcp

Demonstrates how to register the Dart MCP server using CLI commands for supported AI development tools.

```bash
claude mcp add --transport http Dart https://mcp.dartai.com/mcp
```

```bash
gemini mcp add --transport http Dart https://mcp.dartai.com/mcp
```

--------------------------------

### Using the Dart Public API

Source: https://help.dartai.com/en/articles/12618292-dart-oauth-integration-guide

Make authenticated requests to the Dart API using the obtained access token.

```APIDOC
## GET /api/v0/public/config

### Description
Make authenticated requests to the Dart API using the obtained access token.

### Method
GET

### Endpoint
https://app.dartai.com/api/v0/public/config

### Parameters
#### Request Headers
- **Authorization** (string) - Required - Bearer token: `Bearer YOUR_ACCESS_TOKEN`.

### Request Example
```bash
curl -X GET https://app.dartai.com/api/v0/public/config \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

### Response
#### Success Response (200)
- **[Response fields depend on the specific endpoint]**

#### Response Example
```json
{
  "example": "response body"
}
```
```

--------------------------------

### Windsurf MCP Server Configuration (JSON)

Source: https://help.dartai.com/en/articles/10733406-dart-mcp

Configuration for Windsurf clients to connect to MCP servers using Dart AI. This involves specifying the command to run and its arguments.

```json
{
  "mcpServers": {
    "Dart": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.dartai.com/mcp"]
    }
  }
}
```

--------------------------------

### Zed Context Server Configuration (JSON)

Source: https://help.dartai.com/en/articles/10733406-dart-mcp

Configuration for Zed clients to establish context server connections with Dart AI. It defines the command path, arguments, and environment variables.

```json
{
  "context_servers": {
    "Dart": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.dartai.com/mcp"],
        "env": {}
      },
      "settings": {}
    }
  }
}
```

--------------------------------

### OAuth Authorization

Source: https://help.dartai.com/en/articles/12618292-dart-oauth-integration-guide

Redirect users to this endpoint to authorize your application and obtain an authorization code.

```APIDOC
## GET /api/oauth/authorize/

### Description
Redirect users to this endpoint to authorize your application and obtain an authorization code.

### Method
GET

### Endpoint
https://app.dartai.com/api/oauth/authorize/

### Parameters
#### Query Parameters
- **client_id** (string) - Required - Your application's client ID.
- **redirect_uri** (string) - Required - The URI to redirect to after authorization.
- **response_type** (string) - Required - Must be set to `code` for the authorization code flow.
- **scope** (string) - Optional - Space-separated list of scopes your application requests (e.g., `read write`).
- **state** (string) - Required - A random string for CSRF protection.

### Scopes
* `read` - View your Dart data
* `write` - Change your Dart data
```

--------------------------------

### OAuth Token Exchange

Source: https://help.dartai.com/en/articles/12618292-dart-oauth-integration-guide

Exchange the authorization code obtained from the `/authorize/` endpoint for an access token.

```APIDOC
## POST /api/oauth/token/

### Description
Exchange the authorization code obtained from the `/authorize/` endpoint for an access token.

### Method
POST

### Endpoint
https://app.dartai.com/api/oauth/token/

### Parameters
#### Request Body
- **grant_type** (string) - Required - Must be set to `authorization_code`.
- **code** (string) - Required - The authorization code received from the redirect.
- **redirect_uri** (string) - Required - The same redirect URI used in the authorization request.
- **client_id** (string) - Required - Your application's client ID.
- **client_secret** (string) - Required - Your application's client secret.

### Request Example
```json
{
  "grant_type": "authorization_code",
  "code": "CODE_FROM_REDIRECT",
  "redirect_uri": "https://yourapp.com/callback",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}
```

### Response
#### Success Response (200)
- **access_token** (string) - The access token for making API requests.
- **token_type** (string) - The type of token, usually `Bearer`.
- **expires_in** (integer) - The lifetime in seconds of the access token.
- **refresh_token** (string) - A token to obtain new access tokens.

#### Response Example
```json
{
  "access_token": "YOUR_ACCESS_TOKEN",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "YOUR_REFRESH_TOKEN"
}
```
```