ACI.DEV: MCP 서버를 통해 600개 이상의 AI 인텔리전스를 위한 도구 통합

1.4K 00

일반 소개

ACI.dev는 AI 인텔리전스가 600개 이상의 도구에 빠르게 통합할 수 있도록 설계된 오픈 소스 인프라 플랫폼입니다. 멀티테넌트 인증과 세분화된 권한 관리를 통해 인텔리전스가 Google 캘린더, Slack, Brave Search와 같은 도구에 안전하게 액세스할 수 있도록 보장합니다. 개발자는 직접 함수 호출을 통해 또는 통합된 MCP ACI.dev는 프로덕션 환경에서 즉시 작동하는 AI 인텔리전스의 신속한 개발을 지원하기 위해 Python SDK와 자세한 설명서를 제공합니다.

기능 목록

600개 이상의 도구와 통합하고 Google 캘린더, Slack, Brave Search 등의 서비스를 지원합니다.
멀티테넌트 인증을 지원하고, 개발자 및 사용자 권한을 관리하며, 데이터 보안을 보장합니다.
도구 검색 및 실행을 간소화하는 통합 MCP 서버를 제공합니다.
직접 함수 호출을 지원하고 다양한 AI 인텔리전스 프레임워크에 적응할 수 있습니다.
개발자가 ACI API를 호출할 수 있는 Python SDK를 제공합니다.
인텔리전트가 작업 의도에 따라 자동으로 도구를 선택할 수 있는 동적 도구 검색을 지원합니다.
타사 도구에 대한 인증 프로세스를 간소화하기 위해 OAuth2 및 API 키 인증을 제공합니다.
자연어 권한 경계를 지원하여 인텔리전스 신뢰성을 높입니다.
사용자가 도구 통합 요청을 제출하거나 코드를 기여할 수 있는 오픈 소스 커뮤니티 지원.
빠른 시작을 지원하기 위해 자세한 문서와 샘플 코드가 제공됩니다.

도움말 사용

설치 및 구성

ACI.dev는 GitHub에서 호스팅되는 오픈 소스 프로젝트입니다. 개발자는 백엔드 서버와 프런트엔드 포털을 포함한 전체 플랫폼을 로컬에 배포하거나 Python SDK를 사용하여 ACI 기능을 통합할 수 있습니다. 자세한 설치 및 사용 단계는 다음과 같습니다:

1. ACI.dev 플랫폼의 로컬 배포

ACI.dev 백엔드 서버 및 프런트엔드 포털을 실행하려면 다음 단계를 따르세요:

코드 베이스 복제터미널에서 다음 명령을 실행하여 ACI 소스 코드를 가져옵니다:
```
git clone https://github.com/aipotheosis-labs/aci.git
cd aci
```

종속성 설치ACI는 Python 3.12+ 및 Docker를 사용합니다. Docker 및 Docker Compose가 설치되어 있는지 확인합니다. backend 디렉토리에 종속 요소를 설치합니다:
```
cd backend
uv sync
source .venv/bin/activate
```
활용 uv 패키지 관리자가 종속성을 설치합니다. 만약 uv를 실행할 수 있습니다:
```
pip install uv
```
환경 변수 구성예제 환경 변수 파일을 복사하여 수정합니다:
```
cp .env.example .env.local
```
존재 .env.local 다음 주요 변수는
- SERVER_OPENAI_API_KEY스마트바디 호출을 위한 OpenAI API 키입니다.
- CLI_OPENAI_API_KEY서버 키 또는 다른 키와 동일합니다.
- Stripe 청구 기능을 사용하는 경우 Stripe CLI를 실행하여 웹훅 서명 키를 받습니다:
```
stripe listen --forward-to localhost:8000/v1/billing/webhook
```
  의 출력을 반환합니다. SERVER_STRIPE_WEBHOOK_SIGNING_SECRET 에 추가 .env.local.
서비스 시작Docker Compose를 사용하여 백엔드 및 프론트엔드를 시작합니다:
```
docker-compose up
```
백엔드 API는 기본적으로 다음과 같이 실행됩니다. localhost:8000프런트엔드 포털은 다음에서 실행됩니다. localhost:3000.
프런트엔드 포털에 액세스: 브라우저에서 열기 http://localhost:3000를 방문하여 계정을 등록하세요. 등록 후 시스템이 자동으로 테스트 프로젝트와 인텔리전스를 생성하고 개발자는 포털을 통해 도구와 권한을 관리할 수 있습니다.

2. Python SDK 사용

코드를 통해서만 ACI 기능을 호출하려는 경우 Python SDK를 사용할 수 있습니다:

SDK 설치하기::
```
pip install aci-python-sdk
```
SDK 초기화하기::
```
from aci import ACI
import os
client = ACI(api_key=os.environ.get("ACI_API_KEY"))
```
ACI_API_KEY ACI.dev 플랫폼에서 사용 가능(http://localhost:3000)는 프로젝트 설정에서 가져옵니다.

예: 사용 가능한 도구 검색::

apps = client.apps.search(intent="搜索网页", allowed_apps_only=False)
print(apps)  # 返回与意图相关的工具列表

예: 실행 도구 기능::

result = client.functions.execute(
function_name="BRAVE_SEARCH__WEB_SEARCH",
function_parameters={"query": {"q": "北京天气"}},
linked_account_owner_id="user123"
)
if result.success:
print(result.data)
else:
print(result.error)

3. 통합 MCP 서버 사용

MCP 서버는 ACI.dev의 핵심 구성 요소이며 애플리케이션 서버와 통합 서버의 두 가지 모드를 제공합니다:

애플리케이션 서버: 지정된 도구에 직접 액세스합니다. 예를 들어 Brave Search 및 Gmail용 애플리케이션 서버를 실행합니다:
```
uvx aci-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id user123
```
통합 서버모든 ACI 도구의 동적 검색 및 실행:
```
uvx aci-mcp unified-server --linked-account-owner-id user123 --allowed-apps-only
```
통합 서버는 두 가지 메타 기능을 제공합니다:ACI_SEARCH_FUNCTIONS(검색 도구) 및 ACI_EXECUTE_FUNCTION(실행 도구)를 사용하여 LLM 컨텍스트 창 공간을 줄였습니다.
계정 링크 구성도구를 사용하기 전에 ACI.dev 플랫폼에서 계정을 연결해야 합니다. 예를 들어 Brave Search를 연결합니다:
```
result = client.linked_accounts.link(
app_name="BRAVE_SEARCH",
linked_account_owner_id="user123",
security_scheme="API_KEY",
api_key="your-brave-api-key"
)
```
OAuth2가 필요한 도구(예: Gmail)의 경우 SDK는 인증 URL을 반환하고 사용자는 브라우저에서 인증을 완료해야 합니다.

4. 특수 기능 작동

동적 도구 검색통합 MCP 서버는 작업 의도에 따라 지능에 의한 자동화된 도구 선택을 지원합니다. 샘플 코드:
```
from aci.meta_functions import ACISearchFunctions
tools = [ACISearchFunctions.to_json_schema(format="OPENAI")]
```
지능형 시체 통과 가능 ACI_SEARCH_FUNCTIONS 작업 관련 도구를 쿼리하세요.
멀티 테넌트 인증: 개발자는 사용자별로 별도의 권한을 설정할 수 있습니다. 예를 들어, 특정 사용자의 Brave Search 계정만 사용하도록 인텔리전스를 제한할 수 있습니다:
```
client.functions.execute(
function_name="BRAVE_SEARCH__WEB_SEARCH",
linked_account_owner_id="user123",
allowed_apps_only=True
)
```
자연어 권한 경계ACI.dev는 자연어로 권한을 정의하는 기능을 지원합니다. 예를 들어 인텔리전스를 '캘린더 읽기'만 하고 '캘린더 수정'은 하지 못하도록 제한하는 것은 프런트엔드 포털 또는 SDK를 통해 구성할 수 있습니다:
```
client.permissions.set(
agent_id="agent123",
boundaries={"calendar": ["read"]}
)
```
커뮤니티 기여개발자는 새로운 도구 통합 요청을 제출하거나 GitHub를 통해 직접 코드를 기여할 수 있습니다. 참조 CONTRIBUTING.md 노래로 응답 Integration Request Template::
```
gh issue create --title "New Integration: Twitter API" --body-file integration_request.yml
```

5. 문서 및 예제 액세스

공식 문서액세스 https://aci.dev/docs 자세한 API 참조 및 튜토리얼을 확인하세요.
도구 목록: 보기 https://aci.dev/tools 지원되는 600개 이상의 도구에 대해 알아보세요.
샘플 프로젝트참조 https://github.com/aipotheosis-labs/aci-agents 지능적인 신체 발달의 예를 살펴보세요.

주의

보안 .env.local API 키는
로컬 개발의 경우 DBeaver를 사용하여 데이터베이스에 연결할 수 있습니다( .env.local)를 클릭하고 데이터 구조를 확인합니다.
Python SDK는 베타 버전이며 호환되지 않는 업데이트가 있을 수 있으므로 GitHub 리포지토리에 있는 릴리스 노트를 따르는 것이 좋습니다.
일부 도구(예: Brave Search)는 사용자가 자체 API 키를 제공해야 하며, 여기에는 타사 수수료가 포함될 수 있습니다.

애플리케이션 시나리오

개인 비서 챗봇
ACI.dev를 사용하여 웹 검색, 캘린더 관리, 이메일 전송을 위한 AI 어시스턴트를 구축하세요. 멀티테넌트 인증을 통해 여러 사용자 간에 계정 데이터를 격리하여 개인 생산성을 높일 수 있습니다.
연구 인텔리전스
개발자는 ACI.dev를 사용하여 Brave Search와 Notion을 통합하여 학술 연구나 시장 분석에 적합한 연구 자료를 자동으로 검색하고 정리하는 인텔리전스를 구축할 수 있습니다.
영업 자동화
ACI.dev는 CRM과 Gmail 통합을 지원하므로 개발자는 잠재 고객 목록을 자동으로 생성하고 이메일을 전송하여 비즈니스 효율성을 개선하는 영업 인텔리전스를 구축할 수 있습니다.
고객 지원 인텔리전스
Zendesk 및 Slack을 ACI.dev와 통합하여 고객 문의에 자동으로 응답하고 엔터프라이즈 고객 서비스를 위한 작업 주문을 관리하는 인텔리전스를 구축하세요.
오픈 소스 커뮤니티 협업
ACI.dev의 오픈 소스 특성 덕분에 개발자들은 플랫폼 생태계를 개선하기 위해 새로운 도구 통합에 기여할 수 있습니다. 예를 들어, 트위터 API를 추가하여 인텔리전스의 기능을 확장할 수 있습니다.

QA

ACI.dev는 어떤 프로그래밍 언어를 지원하나요?
주로 파이썬 SDK를 통해 파이썬을 지원하여 API를 호출합니다. 다른 언어는 REST API를 통해 액세스할 수 있으며, 자체 HTTP 요청을 구현해야 합니다.
새 도구 통합을 추가하려면 어떻게 하나요?
GitHub 리포지토리에 액세스하려면 다음을 참조하세요. CONTRIBUTING.md 노래로 응답 Integration Request Template를 클릭하고 도구 통합 요청을 제출하거나 직접 코드를 기여하세요.
통합 MCP 서버의 장점은 무엇인가요?
통과(청구서 또는 검사 등) ACI_SEARCH_FUNCTIONS 노래로 응답 ACI_EXECUTE_FUNCTION 600개 이상의 도구 관리를 통합하고, LLM 컨텍스트 창 점유를 줄이며, 인텔리전스의 효율성을 개선하는 두 가지 메타 기능을 제공합니다.
각 도구마다 별도의 인증을 구성해야 하나요?
아니요. ACI.dev는 개발자가 플랫폼에서 계정을 연결하기만 하면 인텔리전스가 도구에 안전하게 액세스할 수 있는 통합 멀티테넌트 인증을 제공합니다.
ACI.dev는 수수료를 부과하나요?
ACI.dev는 오픈 소스 플랫폼으로 무료로 사용할 수 있습니다. 일부 도구는 사용자가 자체 API 키를 제공해야 할 수 있으며, 여기에는 타사 수수료가 포함될 수 있습니다.
스마트 바디의 안전한 작동을 보장하려면 어떻게 해야 하나요?
ACI.dev는 세분화된 권한 관리와 자연어 권한 경계를 제공하여 개발자가 프런트엔드 포털 또는 SDK를 통해 인텔리전스의 작동 범위를 설정할 수 있도록 합니다.