이 페이지에는 Cloud의 URL이 표시됩니다. Dedicated에서 로그인하면 귀사 서버의 URL이 표시됩니다.

AI 어시스턴트 연결(MCP)

Claude Code, claude.ai 또는 MCP를 지원하는 어떤 어시스턴트에서든 귀사의 텔레메트리에 대해 질문하세요. 어시스턴트는 본인 계정으로 로그인하고, 선택한 조직만 읽으며, 아무것도 변경할 수 없습니다.

빌드DARTASTIC 아키텍처사용자토큰이슈Pub 토큰pushCI 토큰 교환앱 배포: 앱 스토어, 웹, 서버심볼크래시스택 트레이스소스 코드텔레메트리개발자 컴퓨터flutter run · dart pub getCIGitHub Actions, GitLab, …Control Room토큰 발급 · 역할 기반 접근 제어컨트롤 플레인조직 · 역할 · 토큰Dartastic Pub패키지 · 소스 코드Observatory세션 · 트레이스 · 로그Symbolizer크래시 → 소스 코드 줄Dartastic AI양쪽 데이터로 답변이슈 트래커GitHub · Jira · Linear모바일 + 데스크톱 앱휴대폰 · 태블릿 · 데스크톱OTLP 토큰으로 전송웹 앱브라우저에서 실행Browser OTLP 토큰으로 전송Dart 서버백엔드 · 서비스OTLP 토큰으로 전송

조직에서 켜기

AI 어시스턴트는 소유자나 관리자가 켜기 전까지 꺼져 있습니다. Control Room에서 AI, Settings 순서로 연 뒤 AI assistants (MCP) 항목을 켜세요. 카드에 조직의 주소가 표시되며, 모든 어시스턴트가 이 주소로 연결합니다. Dartastic Cloud에서는 주소가 https://cloud.dartastic.io/mcp입니다.

그러면 조직에서 Observatory를 볼 수 있는 모든 사람이 연결할 수 있습니다: 소유자, 관리자, Observatory Viewer, Observatory Editor.

Claude Code

터미널에서 서버를 한 번 추가하세요:

shell
claude mcp add --scope user --transport http dartastic https://cloud.dartastic.io/mcp

--scope user 옵션을 쓰면 모든 프로젝트에서 사용할 수 있습니다. 이 옵션이 없으면 Claude Code는 명령을 실행한 폴더에만 서버를 추가하므로, 다른 곳에서 시작한 세션에는 서버가 나타나지 않습니다. 이미 실행 중이던 세션은 다시 시작해야 새 서버를 인식합니다(claude --continue 옵션으로 대화를 다시 열 수 있습니다).

그런 다음 Claude Code에서 /mcp 명령을 실행하세요. dartastic 서버가 인증 필요 상태로 표시됩니다. 서버를 선택한 뒤 Authenticate 항목을 선택하세요. 브라우저에서 dartastic.io가 열리면 로그인하고, 조직을 선택한 뒤 Allow 버튼을 선택하세요. 그러면 브라우저가 본인 컴퓨터의 페이지(localhost)로 이동해 로그인이 완료되었다고 알려 줍니다. Claude Code가 로그인 정보를 받는 과정이며, 이 탭은 닫아도 됩니다. Claude Code로 돌아오면 dartastic 서버가 연결되어 있습니다. 이제 질문해 보세요:

  • “어제 checkout-app에서 가장 느렸던 화면은 무엇인가요?”
  • “지난 1시간 동안의 오류와 그 오류가 발생한 트레이스를 보여 주세요.”
  • “오늘 rum2@example.com 사용자의 세션을 찾고, 그 세션에서 무엇이 잘못되었는지 알려 주세요.”

claude.ai 및 기타 어시스턴트

claude.ai에서는 조직의 주소로 사용자 지정 커넥터를 추가하세요. HTTP를 통한 원격 MCP 서버를 지원하는 다른 어시스턴트도 같은 주소를 사용합니다. 어느 어시스턴트든 같은 방식으로 dartastic.io를 통해 로그인하고, 읽을 조직을 묻습니다.

여러 조직

Cloud에서는 연결 하나로 허용한 모든 조직(최대 32개)을 읽을 수 있습니다. 질문마다 읽을 조직이 지정되므로 전환할 때 다시 로그인할 필요가 없습니다. Dedicated 서버에는 조직이 하나뿐이므로 연결도 그 조직만 읽습니다.

조직을 추가하려면, 어시스턴트가 읽을 수 없는 조직에 대해 질문했을 때 어시스턴트가 알려 주는 링크를 여세요. 다른 소속 조직 중에서 선택하면 어시스턴트가 다시 연결하지 않고도 해당 조직을 읽을 수 있습니다. 세션이 만료되었거나 해당 조직이 자체 ID 공급자를 요구하는 경우에만 다시 로그인합니다.

어시스턴트가 읽을 수 있는 데이터

조직의 서비스, 트레이스, 로그, 메트릭, 세션, 버벅거림이 잦은 지점, 그리고 앱이 보내는 속성의 카탈로그: Observatory에서 보는 것과 같은 텔레메트리입니다. 허용한 조직만 읽으며, 각 조직도 본인에게 접근 권한이 있는 동안에만 읽습니다. 어시스턴트가 하는 어떤 작업도 데이터, 설정, 앱을 변경하지 않습니다.

어시스턴트가 읽은 내용은 어시스턴트와 그 뒤의 AI 모델로 전달됩니다. 텔레메트리를 맡길 수 있는 어시스턴트만, 조직의 AI 도구 규정에 따라 연결하세요.

로그인 유지

어시스턴트를 허용하면 사용하는 동안 연결이 유지됩니다. 7일 동안 사용하지 않은 연결은 종료되며, 모든 연결은 30일이 지나면 종료됩니다. 그 후에는 어시스턴트가 다시 로그인하라고 요청합니다.

연결 해제

  • 어시스턴트 하나: Control Room에서 Profile 화면을 여세요. Connected AI assistants 항목에 각 어시스턴트가 조직, 마지막 사용 시각과 함께 나열됩니다. Revoke 버튼을 선택하세요.
  • 조직의 모든 사람: 소유자나 관리자가 AI, Settings에서 AI 어시스턴트를 끕니다. 조직에 대한 모든 연결이 즉시 종료됩니다.
  • 조직에서 탈퇴하거나 조직의 Observatory에 대한 접근 권한을 잃어도 해당 조직에 대한 연결이 종료됩니다.

알아 두면 좋은 점

  • 로그인 페이지에는 어시스턴트가 스스로 지정한 이름이 표시됩니다. 방금 직접 연결을 시작한 어시스턴트만 허용하세요.
  • 자체 어시스턴트를 통한 질문은 Dartastic 모델을 실행하지 않으므로 Dartastic AI의 일일 질문 수에 포함되지 않습니다.