Setup Guide

This guide walks you through Phennec's initial setup — from creating your account to connecting your tools and getting context flowing to your AI agent.

1. Create an Account

Access the Phennec Control Panel.
Click Sign Up and fill in your details.

2. Create a Project

Click Projects in the sidebar.
Click Add Project.
Enter a project name and complete creation.

3. Add Connectors

From your newly created project, click Connectors > Create Connector.

GitLab Integration

You'll need a GitLab Personal Access Token to connect your repositories.

In GitLab

Log in to GitLab
Open Profile → Edit Profile → Access Tokens
Click Add new token (*)
- Select scopes read_repository and read_api
Click Create token and copy the generated token

In the Phennec Control Panel

Create a GitLab connector
Paste the repository URL as the Project URL, and the access token into the token field
Click Create
On the Connectors screen, click the ••• menu on the GitLab connector you just created
Select Sync Now

* You must have Maintainer or Owner permissions for the target project. If a Personal Access Token does not work, create a Project Access Token from Settings → Access Tokens within the project.

Google Drive Integration

You'll need to share your Google Drive folder with Phennec's service account.

In Google Drive

Open the Google Drive folder you want to connect
Click Share
Add the following account as Editor:
syncer@phennec.iam.gserviceaccount.com

In the Phennec Control Panel

Create a Google Drive connector
Click the ••• menu on the Google Drive connector you just created (in the Connectors screen)
Select Sync Now

Backlog Integration

In Backlog

Copy the URL of the Backlog project you want to connect
Open Personal Settings → API → Register
Generate an API key and copy it

In the Phennec Control Panel

Create a Backlog connector
Enter the Backlog project URL and the API key
Click Create
On the Connectors screen, click the ••• menu on the Backlog connector you just created
Select Sync Now

Notion Integration

You'll need to create a Notion integration to connect your pages.

In Notion

Open Settings → Integrations (*)
Click New Integration to create an integration
Open your newly created integration's settings page
Click Show and copy the secret token
Open the parent Notion page you want to connect to Phennec
Click the ••• menu in the top-right corner of the page
Select Connections, then select the integration you created

In the Phennec Control Panel

Create a Notion connector
Paste the Notion page URL as the Project URL, and the secret token into the token field
Click Create
On the Connectors screen, click the ••• menu on the Notion connector you just created
Select Sync Now

* If you do not have permission to create Notion integrations, ask someone in your organization to provide the secret token.

DocBase Integration

In DocBase

Copy the URL of the DocBase group you want to connect
Open Account Settings → Access Tokens → Create Token
Configure the following:
- Target Group: Select the group you want to connect
- Scopes: Read-only
Create the token and copy it

In the Phennec Control Panel

Create a DocBase connector
Enter the DocBase group URL and the access token
Click Create
On the Connectors screen, click the ••• menu on the DocBase connector you just created
Select Sync Now

4. Setup with Cursor (MCP)

In the Phennec Control Panel, click your profile icon > MCP to open the MCP configuration screen
Click the Quick Setup link
If prompted, allow your browser to open Cursor
Confirm you are directed to the Tools & MCP settings screen, with the Phennec MCP details and your personal token pre-filled
Click Install to complete the setup

This only needs to be done once.

Once installed, open the Cursor chat (CMD+L) and mention phennec in your prompt to pull in context automatically.
Example: phennec @Codebase How does the login page work?

If you have multiple projects, the global MCP connection provides access to all of them. To keep context accurate, include the project name in your initial prompt and use a separate chat per project.

Phennec automatically pulls the most up-to-date, relevant context from your docs and code and delivers it to the AI agent inside Cursor or any other tool you use with Phennec.