Model Context Protocol

SEC.00

Connect Beringin AI to Your Coding Tools

Manage projects, create tasks, and search across your Beringin workspace from Claude Code, Cursor, VS Code, and other AI tools.

12+

AI coding tools supported

min setup

MCP tools available

SEC.01

What is Model Context Protocol?

MCP Protocol

MCP is like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect devices, MCP provides a standardized way to connect AI tools to external systems like Beringin AI.

You

Natural language prompt

AI Coding Tool

Claude Code · Cursor · VS Code · Windsurf · +8 more

MCP Client

JSON-RPC 2.0 · HTTPS · OAuth

Beringin MCP Server

Global

Project

Write

Beringin DB

Your projects, tasks, and data

Remote (HTTP/SSE)

Tools

Executable functions that AI can invoke to perform actions — like creating tasks, querying projects, or searching across your workspace.

Resources

Data sources that provide contextual information to AI — like project details, task lists, and team member information.

Prompts

Reusable templates that help structure AI interactions — like system prompts and few-shot examples.

How It Connects

Remote

Remote (HTTP/SSE)

Uses HTTP with optional streaming for remote server communication. Best for teams and multi-device workflows.

Access from any computer

Secure OAuth2 authentication

Share across team members

SEC.02

Supported Coding Tools

Beringin AI's MCP server works with any spec-compliant client. Here are the most popular ones:

Tool	Config File	Root Key	Transports	Status
Claude Code	`.mcp.json`	`mcpServers`	stdio, HTTP	Verified
Claude Desktop	`claude_desktop_config.json`	`mcpServers`	stdio	Verified
Cursor	`.cursor/mcp.json`	`mcpServers`	stdio, HTTP	Verified
OpenCode	`opencode.json`	`mcpServers`	stdio, HTTP	Verified
VS Code + CopilotDifferent root key	`.vscode/mcp.json`	`servers`	stdio, HTTP	Verified
Windsurf	`mcp_config.json`	`mcpServers`	stdio, HTTP	Verified
Cline	`cline_mcp_settings.json`	`mcpServers`	stdio, SSE	Verified
Continue.devYAML format	`.continue/config.yaml`	`mcpServers`	stdio, HTTP	Verified
ZedDifferent root key	`settings.json`	`context_servers`	stdio, HTTP	Verified
JetBrains IDEs	`Settings UI`	`GUI`	stdio, HTTP	Verified
Amazon Q	`.amazonq/default.json`	`structured`	stdio, HTTP	Verified
Gemini CLI	`Native`	`-`	stdio, HTTP	Verified

Claude Code

Config:: .mcp.json
Root key:: mcpServers
Transports:: stdio, HTTP

Claude Desktop

Config:: claude_desktop_config.json
Root key:: mcpServers
Transports:: stdio

Cursor

Config:: .cursor/mcp.json
Root key:: mcpServers
Transports:: stdio, HTTP

OpenCode

Config:: opencode.json
Root key:: mcpServers
Transports:: stdio, HTTP

VS Code + Copilot

Config:: .vscode/mcp.json
Root key:: servers
Transports:: stdio, HTTP

Windsurf

Config:: mcp_config.json
Root key:: mcpServers
Transports:: stdio, HTTP

Cline

Config:: cline_mcp_settings.json
Root key:: mcpServers
Transports:: stdio, SSE

Continue.dev

Config:: .continue/config.yaml
Root key:: mcpServers
Transports:: stdio, HTTP

Zed

Config:: settings.json
Root key:: context_servers
Transports:: stdio, HTTP

JetBrains IDEs

Config:: Settings UI
Root key:: GUI
Transports:: stdio, HTTP

Amazon Q

Config:: .amazonq/default.json
Root key:: structured
Transports:: stdio, HTTP

Gemini CLI

Config:: Native
Root key:: -
Transports:: stdio, HTTP

SEC.03

Beringin AI MCP Tools

18 tools

18 tools available via MCP, organized by scope. All tools respect your existing project permissions.

Cross-Project Tools· 6 tools

get_user_profile

Get your profile information (name, email, tier, organizations)

"What's my profile?"

list_my_projects

List all projects you have access to

"List my projects"

get_project_summary

Get a summary of a specific project

"Show summary of Website Redesign"

find_tasks_across_projects

Search tasks across all projects

"Find tasks about login"

get_overdue_tasks

Find overdue tasks across projects

"What tasks are overdue?"

compare_projects

Compare metrics between projects

"Compare Project A and B"

Project Read Tools· 10 tools

list_project_tasks

List tasks in a specific project

"Show tasks in Mobile App"

get_task_details

Get detailed task information

"Get details of task Fix login"

list_card_tables

List Kanban boards

"List Kanban boards"

get_card_table_details

Get board details with cards

"Show Sprint 1 board"

list_schedule_events

List upcoming calendar events

"What's on the schedule?"

list_team_chats

List team chat channels

"List team chat channels"

get_team_chat_messages

Get chat messages

"Show recent chat messages"

find_project_items

Search within a project

"Search for auth in project"

summarize_project_updates

Summarize recent activity

"Summarize recent activity"

list_project_members

List team members

"Who's in this project?"

Project Write Tools· 2 tools

create_project_task

Create a new task (name-based assignment)

"Create task Fix bug assigned to Budi"

update_project_task

Update an existing task

"Update task Fix bug to In Progress"

SEC.04

Setup Guides

Beringin AI connects to your coding tool via Remote (HTTP). Follow these steps — most setups take less than 5 minutes.

Add Beringin to Your AI Tool

Copy the config snippet for your tool below. Beringin uses OAuth — no API token needed.

→ File: .mcp.json at project root (shared with team) or ~/.claude.json (user-wide)

JSON

{
  "mcpServers": {
    "beringin": {
      "url": "http://localhost:3005/api/mcp"
    }
  }
}

Remote connection — works from any computer

Authorize via OAuth

Connections use OAuth2 — no long-lived tokens to leak. You authorize each tool through Beringin's login.

Test It

"List my projects"

"Show tasks in [project]"

"Create task Fix bug"

"What tasks are overdue?"

SEC.05

Example Use Cases

Here's what you can ask your AI tool once connected:

Say This in Your AI Tool	What Happens in Beringin
`"List my projects"`	Shows all your Beringin projects with status and stats
`"Show tasks in Website Redesign"`	Lists all tasks in the specified project
`"Create task Fix login bug assigned to Budi"`	Creates a new task with name-based assignment
`"What tasks are overdue?"`	Checks overdue tasks across all your projects
`"Compare Website Redesign and Mobile App"`	Side-by-side comparison of project metrics
`"Search for authentication tasks"`	Full-text search across all projects
`"Summarize recent activity in Mobile App"`	AI-generated summary of recent changes
`"Update task Fix login to In Progress"`	Changes task status

"List my projects"

Shows all your Beringin projects with status and stats

"Show tasks in Website Redesign"

Lists all tasks in the specified project

"Create task Fix login bug assigned to Budi"

Creates a new task with name-based assignment

"What tasks are overdue?"

Checks overdue tasks across all your projects

"Compare Website Redesign and Mobile App"

Side-by-side comparison of project metrics

"Search for authentication tasks"

Full-text search across all projects

"Summarize recent activity in Mobile App"

AI-generated summary of recent changes

"Update task Fix login to In Progress"

Changes task status

SEC.06

Security & Permissions

Here's how we keep your Beringin workspace safe:

Secure OAuth

Connections use OAuth2 — no long-lived tokens to leak. You authorize each tool through Beringin's login.

Revoke Anytime

Disconnect any tool instantly from Settings > Connected Apps. Access is immediately cut off.

Audit Trail

All MCP actions are logged with timestamps. Review who did what and when.

Scoped Access

Tools only see projects you have access to. No admin access = no admin tools.

HTTPS Encryption

Remote connections use HTTPS with TLS encryption end to end.

Token Scopes

Grant read-only access for monitoring, or read-write for full control.

Permission Matrix

Role	Read (15 tools)	Write (2 tools)	Admin (delete)
Viewer
Editor
Admin
Owner

Viewer

ReadWriteAdmin

Editor

ReadWriteAdmin

Admin

ReadWriteAdmin

Owner

ReadWriteAdmin

SEC.07

Troubleshooting

Common issues and how to fix them:

Make sure you completed the Beringin login and clicked Authorize
Check that pop-ups are allowed for your AI tool
Re-trigger the OAuth flow by restarting your AI tool

Get Started

Connect your AI tool in under 5 minutes via secure OAuth.

View Connected Apps