AI 어시스턴트 및 MCP 서버
이 페이지의 모든 기능은 무료입니다.
원하는 제공업체 사용
어시스턴트는 GitHub Copilot, ChatGPT, Cursor, Claude, Claude Agent, OpenAI, OpenRouter, Gemini, xAI, Ollama, llama.cpp, MLX, OpenCode Zen 및 OpenAI-compatible 제공업체를 지원합니다. 제공업체에 따라 API 키를 붙여넣거나 기존 계정으로 로그인하거나 Mac에서 모델을 실행합니다. TablePro는 자체 AI 서비스를 운영하지 않습니다. 요청은 제공업체로 직접 전달되며 추가하기 전에는 아무것도 전송되지 않습니다.
각 메시지에는 설정한 한도 내의 연결 테이블 구조와 편집기의 쿼리가 포함됩니다. 결과 행은 Settings > AI에서 켠 경우에만 전송됩니다. 각 연결에는 AI 정책도 있으며 Never는 어시스턴트와 MCP 클라이언트 모두의 접근을 막습니다.
검토, 설명, 최적화 및 수정
구문에 커서를 놓고 Review with AI(⌥⇧⌘L)로 정확성, 비용 및 안전성을 검토하거나 Explain(⌘L)으로 단계별 동작을 설명받거나 Optimize(⌥⌘L)로 재작성 또는 인덱스를 제안받습니다. 쿼리가 실패하면 오류 배너에 Fix with AI가 나타납니다. 요청에는 구문이 참조하는 테이블 구조가 포함되며 구문 자체는 실행되지 않습니다. Apply to Editor는 확인한 뒤에만 구문을 대체합니다.
인라인 제안은 입력 중 흐릿한 텍스트로 표시되며 기본적으로 꺼져 있습니다. AI Rules는 절대로 선택하면 안 되는 열 같은 일반 텍스트 메모를 연결에 지정하고 모든 메시지에 포함합니다.
채팅 모드 및 Agent 모드
채팅에는 세 모드가 있습니다. 기본인 Ask는 스키마를 조회하고 아무것도 실행하지 않습니다. Edit는 쿼리도 실행하고 Agent는 DROP, TRUNCATE와 기타 파괴적 구문도 실행할 수 있습니다. 새 연결의 기본 안전 모드인 Silent에서는 Edit와 Agent의 쓰기가 확인 없이 실행됩니다. Alert부터 Safe Mode (Full)까지는 각 작업이 Run을 기다리고 Read-Only는 거부합니다. 파괴적 구문은 항상 클릭을 기다리며 미리 승인할 수 없습니다.
Agent 모드(⌥⇧⌘A)는 한 세션에 창 전체를 할당해 이 연결의 세션, 대화 및 제안하고 실행한 SQL을 보여 줍니다. 켜져 있는 동안 연결은 Alert 이상으로 유지되므로 Run을 클릭하기 전에는 쓰기가 실행되지 않습니다. 이는 알림이지 잠금이 아니며 키 한 번으로 끌 수 있습니다. 세션은 이 Mac에만 저장됩니다.
MCP 서버
내장 MCP 서버는 AI 클라이언트가 비밀번호를 보지 않고 TablePro에 저장된 연결을 사용하게 합니다. 127.0.0.1에서만 수신하며 원격 모드는 없습니다. 직접 켜거나 설정한 클라이언트가 시작하기 전까지 꺼져 있습니다.
도구는 연결, 스키마 탐색, 데이터 읽기·쓰기, 데이터베이스와 객체, 서버 관리 및 앱의 탭과 기록을 다루며 실제 스키마로 프롬프트와 리소스를 만듭니다. 모든 호출은 Mac의 활동 로그에 기록되고 구문은 텍스트가 아닌 다이제스트로 저장됩니다. 클라이언트가 실행한 쿼리는 쿼리 기록에도 표시됩니다.
클라이언트 연결
Settings > Integrations에는 Claude Code, Claude Desktop, Cursor 및 Zed 설정 단계와 복사할 코드 조각이 있습니다. 번들 tablepro-mcp 브리지는 Claude Desktop, Claude Code, Cursor, VS Code, Cline, Continue, Zed, Windsurf, Antigravity 및 Goose도 지원하며 필요하면 TablePro를 시작하고 서버를 찾으므로 클라이언트 설정에 포트나 토큰을 넣지 않습니다. 공식 Raycast 확장은 앱과 페어링하며 Mac에서 이를 승인합니다.
예를 들어 클라이언트에 같은 이메일 주소를 쓰는 사용자를 찾아달라고 할 수 있습니다. 클라이언트는 list_tables와 describe_table을 호출해 열 이름이 email_address임을 확인하고 저장된 연결로 SELECT 하나를 실행합니다. 채팅에 스키마를 붙여넣을 필요가 없습니다.
클라이언트에 허용되는 작업
모든 호출은 다음 검사를 모두 통과해야 하며 가장 엄격한 조건이 적용됩니다.
- 토큰 범위: Read Only, Read & Write 또는 Full Access이며 지정한 연결로 제한할 수 있습니다. 브리지는 자동으로 Read & Write 토큰을 받으므로 이를 쓰는 클라이언트는 파괴적 구문을 실행할 수 없습니다.
- 연결별 External Clients: Blocked, Read Only(기본값) 또는 Read & Write. 차단된 연결은 목록에도 표시되지 않습니다.
- 연결 승인: 클라이언트가 연결에 처음 접근하면 Mac의 대화상자에서 확인합니다. 매번, 연결당 한 번 또는 확인하지 않음 중 선택합니다.
- AI 정책: Never로 설정한 연결은 MCP 클라이언트도 거부합니다.
- 안전 모드: 쓰기는 연결 수준에 따라 확인하며 DROP이나 TRUNCATE에는 Full Access 토큰과 매번 승인이 필요합니다. 파일을 읽거나 쓰거나 서버에서 코드를 실행하는 구문은 거부됩니다.
외부 MCP 서버
반대 방향도 가능합니다. TablePro의 AI 세션은 운영하는 MCP 서버의 도구를 Streamable HTTP로 호출할 수 있으며 서버가 이 Mac에 있지 않으면 HTTPS가 필요합니다. 각 서버를 제공할 연결을 선택합니다. 모든 호출은 카드를 표시하고 클릭을 기다리며 포괄적인 사전 승인은 적용되지 않습니다. 서버 주소와 토큰은 이 Mac에만 저장됩니다.
채팅 밖의 자동화
AppleScript는 연결의 External Clients 수준과 안전 모드 안에서 연결하고 쿼리를 실행하고 테이블을 열 수 있습니다. tablepro:// 링크는 연결, 테이블 또는 쿼리 탭을 엽니다. 링크의 쿼리는 확인 후 입력되며 자동으로 실행되지 않습니다. postgresql:// 같은 데이터베이스 URL은 연결로 열립니다.
tablepro 셸 명령은 해당 URL과 파일을 앱에서 열며 터미널에서 쿼리를 실행하지 않습니다. 공식 Raycast 확장은 연결, 테이블 및 쿼리 기록을 검색하고 페어링된 앱을 통해 쿼리를 실행합니다.
데이터가 전달되는 곳
프롬프트, 스키마 컨텍스트와 첨부한 내용은 선택한 제공업체에 해당 계정의 약관에 따라 전달됩니다. Ollama, llama.cpp, MLX 또는 직접 운영하는 OpenAI 호환 서버를 사용하면 본인 기기에 남습니다. TablePro는 어떤 내용도 받지 않으며 Mac 앱의 일일 사용 보고에는 AI나 MCP 정보가 포함되지 않습니다.
GitHub Copilot을 추가하면 GitHub로 텔레메트리를 보내는 옵션이 기본적으로 켜져 있습니다. Copilot 설정에서 끌 수 있습니다.
iPhone과 iPad에서는 제공하지 않음
iPhone과 iPad 앱에는 AI 어시스턴트, Agent 모드 또는 MCP 서버가 없습니다. 이 페이지의 모든 기능은 Mac 앱에 있습니다.
지원 범위
| 기능 |
|---|
| 자체 제공업체를 사용하는 AI 채팅Mac: 무료iPhone 및 iPad: 지원되지 않음 |
| AI로 검토, 설명, 최적화 및 수정Mac: 무료iPhone 및 iPad: 지원되지 않음 |
| 인라인 제안 및 AI 규칙Mac: 무료iPhone 및 iPad: 지원되지 않음 |
| Agent 모드Mac: 무료iPhone 및 iPad: 지원되지 않음 |
| MCP 서버Mac: 무료iPhone 및 iPad: 지원되지 않음 |
| 외부 MCP 서버Mac: 무료iPhone 및 iPad: 지원되지 않음 |
AppleScript 및 tablepro 셸 명령Mac: 무료iPhone 및 iPad: 지원되지 않음 |
| Raycast 확장Mac: 무료iPhone 및 iPad: 지원되지 않음 |
알아둘 제한 사항
- Cursor는 TablePro 도구를 호출할 수 없으므로 Cursor를 제공업체로 사용하면 Edit와 Agent는 쿼리를 실행하지 않습니다. 로컬 모델은 해당 모델이 지원할 때만 도구를 호출합니다.
- Claude Agent는 Claude Code 로그인을 사용하고 켜져 있어야 하는 MCP 서버를 통해 스키마에 접근합니다. Claude Code에 의존하므로 Claude Code 릴리스로 인해 작동하지 않을 수 있습니다.
- MCP 서버는 127.0.0.1에서만 수신합니다. 다른 기기에서 접근하려면 직접 포트를 전달하고 그로 인해 노출되는 범위를 책임져야 합니다.
- Mac 앱에는 단축어 동작이 없습니다. AppleScript, 링크 또는 MCP 서버로 자동화하세요.
- Agent 세션과 외부 MCP 서버는 설정한 Mac에만 남으며 동기화되지 않습니다.
